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About This Book 



NetView Administration Reference describes the NetView™ program definition 
statements required for system administration. System administration is the 
process of redefining system defaults and storage requirements to improve 
network efficiency. This book also contains appendixes that contain external log 
record formats, network asset management information, a modem configuration 
change form, and lists of command keywords and values that can be scope 
checked. 

This book is intended to provide the customer with an understanding of the 
NetView program definition statements required for system administration. It pri- 
marily contains descriptions of all the definition statements. Unless specifically 
stated otherwise, the information in this book must not be used for programming 
purposes. However, this book also provides the following types of information, 
which are explicitly identified where they occur: General-use programming inter- 
faces are provided to allow the customer to write programs that use the services of 
the NetView program. 



Who Should Use This Book 



NetView Administration Reference is a reference source for system programmers 
and network operators who need a complete understanding of the NetView 
program definition statements, or need to use the information in the appendixes. 



How to Use This Book 

This section includes information about the organization, terms, and coding con- 
ventions used in this book. 

How This Book Is Organized 

This book is organized into the following sections: 

Chapter 1, "Definition Statement Reference" is an alphabetical listing of all defi- 
nition statements. Each entry contains an explanation of the purpose of the state- 
ment and identifies the member where it is used. The format of each entry 
provides all operands, default values, and information that must be supplied in the 
statement. See "How to Use the Definition Statement Reference" on page 3 for 
instructions on how to find information in this chapter. 

Appendix A, "External Log Record Formats" provides external log record formats 
for the hardware monitor and session monitor. 

Appendix B, "Network Asset Management Vital Product Data Descriptions and 
Sample Record Formats" provides information about the sample Network Asset 
Management command lists. 
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Appendix C, "Modem Configuration Change Form" provides a one-page form that 
system programmers can use to give modem configuration information to opera- 
tors. 

Appendix D, "Command Keywords and Values that can be Scope Checked" pro- 
vides a fist of the NetView commands having keywords that can be scope checked. 

Notes on Terms Used in This Book 

Following is a list of terms and the meanings they have in this book. Unless other- 
wise noted, abbreviations for products refer to the latest version and release of the 
product. 

Term Meaning 

command lists command lists written in rexx and command lists written in the 
NetView command list language 

member member in the specified data set (mvs) and file name with a file 

type of NCCFLST (VM) 

MVS mvs/xa, mvs/esa (compatibility mode) 

REXX Restructured Extended Executor language 

VM vm/sp, vm/sp hpo, and vm/xa (compatability mode) 

VTAM VTAMV3R1.1, VTAMV3R1.2, andVTAMV3R2. 

Coding Conventions Used in This Book 

The model statements are formatted according to a set of coding conventions 
which are described in this section. 

Brackets [ ] 

When brackets enclose an operand, they indicate a completely optional 
specification. This includes any accompanying commas or equal signs. 
Do not include brackets when coding the specification. 

OR-sign | 

The OR-sign separates choices for an optional or required specification. 
If a group of options is enclosed by brackets and the individual options 
are separated by OR-signs, none of the options in the group has to be 
chosen. Do not include the OR-signs when coding the specification. 

UPPERCASE Characters 

You must spell command names or operands shown in UPPERCASE 
BOLD characters exactly as they appear. These names are program 
keywords. 

lowercase Characters 

Lowercase, italic characters describe the type of program variable 
information that must be supplied, rather than an actual value. Replace 
the lowercase, italic word with the actual value. 

underscored Characters 

Underscored characters indicate default values . These values are auto- 
matically assigned unless you specify a different value. 

Parentheses ( ) 

The parentheses enclose parameters that must be entered along with 
the parentheses. 
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Ellipsis ... 

An ellipsis replaces a repetition of an operand or variable in syntax 
statements. Replace ellipses with the appropriate operand or variable 
when you code. 



What Is New In This Book 



This book describes the following additions and changes to the NetView definition 
statements for NetView Release 3: 

• The following definition statements are new: 

- DEFFOCPT 

- RATE 

- VPDINIT. 

• The following definition statements have new keywords: 

- CDRMDEF 

- CNMTARG 

- DSTINIT 

- IF-THEN 

- INITMOD. 

• The racf keyword on the options statement has been changed to maximum. 

Appendix B, "Network Asset Management Vital Product Data Descriptions and 
Sample Record Formats" on page 123 has been added to this book. This appendix 
contains information about the data returned from the vpdcmd command and the 
sample network asset management command lists. 
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Where To Find More Information 



Table 1 shows all of the publications in the NetView Release 3 library, arranged 
according to related tasks. For more information on these and other related publi- 
cations, see "Bibliography" on page 169. 

Table 1. The NetView Library 

Evaluation and Education 

Network Program Products General Information GC30-3350 

Bibliography and Master Index for NetView, NCP, and VTAM GC31-6081 

Learning about NetView: Operator Training (pc Diskettes) SK2T-0292 



Planning 

Network Program Products Planning 
NetView Storage Estimates (PC Diskettes) 
Console Automation Using NetView: Planning 



SC30-3351 
SK2T-1988 
SC31-6058 



Installation and Administration 

NetView Installation and Administration Guide 
NetView Administration Reference 
Network Program Products Samples 
NetView Tuning Guide 



SC31-6018 
SC31-6014 
SC30-3352 
SC31-6079 



Customization 

NetView Customization Guide 
NetView Customization: Writing Command Lists 
NetView Customization: Using PL/I and C 
NetView Customization: Using Assembler 



SC31-6016 
SC31-6015 
SC31-6037 
SC31-6078 



Operation 

NetView Operation Primer 

NetView Operation 

NetView Command Summary 



SC31-6020 
SC31-6019 
SX75-0026 



Diagnosis 

NetView Problem Determination and Diagnosis LY43-0001 

NetView Resource Alerts Reference SC3 1-6024 

NetView Problem Determination Supplement for LD21-0023 

Management Services Major Vectors 0001 and 0025 
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Chapter 1. Definition Statement Reference 



This chapter contains a description of the definition statements used by the 
NetView program. 

NetView definition statements are used for performing system administration tasks. 
System administration is the process of redefining system defaults and storage 
requirements. This process involves several subtasks. Administration subtasks 
can be performed during NetView installation, or when you redefine network 
resources. 

In planning for installation and network management tasks, you determined the 
facilities you need to run NetView. You identified hardware requirements and spe- 
cific resources used by NetView. This led to decisions on requirements for user 
coding and NetView definitions. You have performed these installation tasks: 

• Completed the planning task 

• Installed and verified the sample network shipped with NetView 

• Determined that NetView definition is required. 

Use the definition statements to accomplish the procedures described in the 
NetView Installation and Administration Guide and Network Program Products 
Samples. Those publications introduced you to the concept of altering the sample 
NetView program definition statements to suit your requirements. After copying 
some of the current definition statements from the sample files, you can begin to 
modify existing definition statements or create new ones. You can alter definition 
statements during a first-time NetView installation, or later while running your pro- 
duction system. 



How to Use the Definition Statement Reference 

You can use the following methods to locate any specific definition statement 
information: 

1. The definition statements are listed alphabetically by statement name. When 
you know a statement name, look it up in alphabetical order. Use the 
dictionary-style headings for quick reference. 

2. When you know only the member name, and want to know optional statement 
names not used in the samples, locate the member name in the index and find 
the statements of interest listed alphabetically. 

3. When you know an operand name but not the statement it is used with, locate 
the operand name in the index. 

The format of a definition statement is as follows: 

• Statement name 

• General introduction 

The general introduction explains overall options, assumpttons, and the 
purpose of the statement. Each introduction tells you the name of the member 
and data set where you code the statement. 
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• Definition statement syntax 

The definition statement syntax is a model statement that is formatted 
according to the coding conventions described in "Coding Conventions Used in 
This Book" on page viii. 

• Definition of each operand 

A description of each operand that can be specified for the definition statement 
is provided. The specific values or variable information that can be specified 
for the operand are described. 

• Cross-reference to related statements 

A listing of other statements that can affect the definition statement is provided. 

Syntax Conventions for Definition Statements 

The following syntax conventions apply to most statements: 

• You must code at least one blank between a label name and the name of the 
definition statement and between the name of the definition statement and the 
first operand. One or more blanks, or a single comma with no blanks, must 
separate the statement operands. The operands cannot be separated by a 
combination of commas and blanks. 

• Continuation from one line to the next is not allowed, except for the if-then 
statement. However, you can repeat the definition statement and add the 
remaining information. For example: 

LOGINIT AUTOFLIP=YES 
LOGINIT RESUME=YES 

is the same as: 

LOGINIT AUTOFLIP=YES,RESUME=YES 

• It is recommended that comments be placed on a separate line for dsiparm 
members. The first column of a comment line must contain an asterisk (*). Do 
not place comments between the beginning and end of a continued if-then 
statement. 

• The label field can only be 8 characters long. 

• Each definition file should conclude with an end statement. This end statement 
has no operands and must not begin in column 1. 

• Command names, command list names, and any other NetView identifiers 
must not contain commas (,), periods (.), blanks, apostrophes ('), ampersands 
(&), asterisks (*), or equal signs (=). Commas, periods, blanks, and equal 
signs are used as delimiters when the definition statements are parsed. The 
other characters have special meanings for NetView command lists. 
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A (Alert) 



A (Alert) Statement 



The a statement defines the color, highlighting, and alarm attributes corresponding 
to the message indicators. Messages in the network log are also displayed in the 
specified colors while browsing the network log data. If an alarm, color, or high- 
lighting attribute is defined for a message, it occurs for each operator who is 
defined to receive the message. This statement is coded in the dsicnm member of 

DSIPARM. 

Note: Message indicator definitions for a given operator are not enabled until the 
operator has been in status monitor. 

Code one a statement for each message indicator class you define. You can code 
four message indicator class statements (1-4). If you code a statements, use 
if-then automation statements to assign messages to the message indicator 
classes. You can use if-then automation statements to route these messages to 
any NetView operators. You can also use f statements to assign messages to the 
message indicator classes and, in this case, the messages are always routed to 
the authorized message receiver. 



vtass eotor notify high alarm console comments 



must be in column 1. 

class 

is the message indicator class number and must be from 1 through 4. The 
message indicator value must be in column 2 of the statement. This number is 
displayed at the top of any status monitor panel and is associated with a 
number on an f statement. 

color 

is the color value for the message indicator class. This value must be in 
column 4 of the statement. The number at the top of any status monitor panel 
(when alerted) and the message in the network log are displayed in the chosen 
color. You can use the following color values: 



B 


Blue 


G 


Green 


P 


Pink 


R 


Red 


T 


Turquoise 


W 


White 


Y 


Yellow 


(blank) 


Default color for the terminal 



notify 

specifies that the alarm and high definitions are triggered for the operators 
when messages in this class arrive. This value must be in column 5 of the 
statement. You can use the following notify values: 

Y The high and alarm values are interpreted. 

N The high and alarm values must be blank. This is the default. 

Note: If notify is n, then high and alarm must be blank. 
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A (Alert) 



high 

is the highlighting value for the message indicator class. This value must be in 
column 6 of the statement. The number at the top of each operator's status 
monitor panel is highlighted according to the highlighting value. 

You can use the following high values: 

B Blink 

R Reverse video 

U Underscored 

(blank) No highlighting. This is the default. 

Note: This value must be blank if notify is n. 

alarm 

is the alarm value for the message indicator class. This value must be in 
column 7 of the statement. When the alarm is set, any message from the class 
triggers an alarm for each operator when the message arrives. The alarm is 
sounded only when the operator is in status monitor. You can use the fol- 
lowing alarm values: 

Y The alarm is sounded when a message arrives. 
N The alarm is not sounded. This is the default. 

Note: This value must be blank if notify is n. 

console 

indicates whether a copy of the message should be sent to the system console. 
This value must be in column 8 of the statement. When this value is set, any 
message from the class is sent to the system console. You can use the fol- 
lowing console values: 

Y A copy of the message is sent to the system console. 

N A copy of the message is not sent to the system console. This is the 
default. 

comments 

is unused space for the statement. Any comments you want included with the 
statement must be in columns 9 through 80. 

Related Statements: f, auth, if-then 
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ALIASMEM 



ALIASMEM Statement 



NetView uses the aliasmem statement to create a table of alias name translations. 
This statement is coded in the member of dsiparm specified by the mem keyword of 
the task statement whose tskid is aliasapl. The precoded member used in samplib 

iS DSIALATD. 

Note: This statement must be coded after the dstinit statement that defines 
dsiainit as the dst initialization exit. 

| [/abe/] AUASMEM membername £,...3 



membername [,...] 

names the members that contain the orignet, lu, cos, and mode definition 
statements. 

Related Statements: cos, dstinit, lu, mode, orignet, task 
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AUTH 



AUTH Statement 



The auth statement defines an operator's authority to control resources. This 
statement also specifies whether an operator can receive unsolicited messages. 
This statement is coded in a member of dsiprf specified by a profilen statement 
associated with the operator. Refer to "PROFILEN Statement" on page 80 and 
"OPERATOR Statement" on page 70 to see how a profilen statement is associated 
with an operator. A precoded member used in the samplib is dsiprofa. 



AUTH [CTL = GLOBAL|SPECIFJC] 

[,MSGRECVR = YES|NO] 



CTL » GLOBALI SPECIFIC 

defines the operator's authority to control resources. The value of this param- 
eter must be one of the following: 

GLOBAL means span of control is not used, domains, ispan, and span state- 
ments are ignored. An operator with global authority can estab- 
lish cross-domain sessions with domains specified by rrd 
statements only. 

SPECIFIC means the operator can only control resources listed on ispan and 
span statements and can only establish cross-domain sessions 
with the nccfids listed on the domains statement, specific is the 
default value for the ctl operand. 

Note: Code maximum or normal on the options statement; otherwise, the span 
of control has no meaning. Refer to "OPTIONS Statement" on page 71 for 
more information about the options statement. 

MSGRECVR = YES|NO 

specifies whether operators using this profile can receive unsolicited mes- 
sages that are not routed to a particular operator by the use of the NetView 
assign command or by message automation. 

YES means that an operator using this profile can be the authorized 

message receiver. 

NO means that operators using the profile containing this statement 

do not receive unsolicited messages, no is the default. 

In NetView, the authorized receiver is the operator who is authorized to 
receive all the unsolicited and authorized messages that are not routed to a 
specific operator with an assign command or a route action in a message auto- 
mation statement. The authorized receiver is determined by the order in which 
operator terminals are defined to NetView and the order in which authorized 
operators have logged on. 
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AUTH 



When several operators are defined to receive a particular message, NetView 
routes the message to the operator who meets the first of the following criteria 
when the message arrives: 

1. The operator designated by an assign command 

2. The operator or operators designated by the route action in the if-then 
message automation statement. 

3. An operator logged on to a pos terminal 

If more than one pos terminal is defined, the one defined first has 
priority. 

4. A pospool operator 

If more than one pospool operator is logged on, the one logged on first has 
priority. 

5. A cross-domain operator 

If more than one cross-domain operator is logged on, the one logged on 
first has priority. 

6. An autotask operator 

If more than one autotask has been started, the one started first has pri- 
ority. You should use the assign command if an autotask is going to be the 
receiver of unsolicited messages. 

7. The system console operator. 

Related Statements: domains, ispan, operator, options, pos, pospool, profile, 

PROFILEN, SPAN 
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C (Command List) Statement 



The c statement lets you assign up to 16 command lists to be displayed on the 
status monitor detail panel. Command lists can be written either in rexx or the 
NetView command list language. This statement is coded in the dsicnm member of 

DSIPARM. 

Code one c statement for each command list you define. You can code up to 16 c 
statements. 



C cmdtistnam& comments 



C 

must be in column 1. 

cmdlistname 

is the name of the command list you want displayed on the status monitor 
detail panel. This value must begin in column 3 of the statement. 

comments 

is unused space for the statement. Any comments you want included with the 
statement must be in columns 11 through 80. 

Related Statements: None 
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CDMNSESS 



CDMNSESS Statement 



The cdmnsess statement is used to specify the maximum number of cross-domain 
sessions that can be started with this NetView from other domains. If you do not 
code cdmnsess for this NetView, no cross-domain sessions can be started from 
other domains. This statement is coded in the dsidmn member of dsiparm. 



. [label ] CDMNSESS n|0 

n\0 

is a decimal number from through 32767 that specifies the maximum number 
of concurrent cross-domain sessions that can be started from other domains 
with this NetView. A logical maximum value is the number of operators in 
other domains who have profiles that specify this NetView in a domains state- 
ment, plus the number of global operators in other domains. The default is 0. 

Note: Do not code a larger number than you need, because NetView sets 
aside storage for each potential session. 

Related Statements: domains 
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CDRMDEF Statement 



The cdrmdef statement sets up cdrmname-nccfid relationships for other domains. 
This allows the dst initialization exit for the access method lu task (dsiamlut), an 
IBM-supplied initialization exit routine, to build a table of these relationships. The 
table is used by the session monitor for session data retrieval from other domains. 
This statement can also be used to eliminate session monitor conversation set-up 
attempts by using the retry keyword. This statement is coded in the member of 
dsiparm specified by the mem keyword of the task statement whose tskid is 
dsiamlut. The precoded member used in samplib is dsiamltd. 

Note: This statement must be coded after the dstinit statement that defines dsilinit 
as the dst initialization exit. 



[iabetj CDRMDEF cdrmname ~domamid[ t „.} 

[RETRY »YES[NO] 



cdrmname = domainld[,...'] 

cdrmname specifies the 1- to 8-character name of a cross-domain sscp 
known in this domain as defined to vtam. 

domainid is the 1- to 5-character NetView identifier that names the NetView 
application in the domain defined by cdrmname. 

RETRY -YES|NO 

defines whether an attempt to allocate a conversation will be made every 10 
minutes if the first attempt fails. The default value is defined on the retry 
parameter of the dstinit statement. The default on dstinit is retry=yes. 

YES means the session monitor attempts to establish an initial conver- 

sation with the other NetView once every 10 minutes. 

NO means the session monitor attempts to establish an initial conver- 

sation with the other NetView only one time. 

Note: If the cdrmdef statement is used, it must follow the dstinit statement. 
Related Statements: cnmtarg, dstinit, nccfid, task 
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CMDCLASS Statement 



The cmdclass statement is used to restrict the usage of a command or command 
list to operators defined in one or more scope classes. Refer to Appendix D, 
"Command Keywords and Values that can be Scope Checked" on page 139 for a 
list of the NetView command keywords and values that can be scope checked. 

Code cmdclass after the cmdmdl statement of the command or command list to 
which it applies and before the next cmdmdl statement. Only operators without any 
opclass statements or the specified scope class can run the specified command. If 
you do not code the cmdclass statement, the command is not limited and any oper- 
ator can use it. This statement is coded in the dsicmd member of dsiparm. 

•:{Ya6e/] CMDCLASS scopeclass £,.,.] ■■• 



scoped ass [,...] 

specifies a scope class that can use this command. The value specified for 
scopeclass must be a number from 1 to 2040. 

Note: When you define scope classes, start with 1 and work up. Using smaller 
numbers saves storage. 

Related Statements: cmdmdl, opclass 
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CMDMDL Statement 



The cmdmdl statement defines commands and command lists to NetView. For 
commands, cmdmdl shows the command name, the module that processes the 
command, the command type, and when the command module is loaded. You 
need to write cmdmdl statements for command lists when: 

• You want them scope checked. 

• You want synonyms for them. 

If a command or command list has a cmdmdl statement, then it can be scope 
checked using the cmdclass statement. Refer to Appendix D, "Command 
Keywords and Values that can be Scope Checked" on page 139 for a list of the 
NetView command keywords and their values that can be scope checked. 

The cmdmdl statement is used in the dsicmd member of dsiparm. 



commandname CMDMDL, MOO **modufename 

[,TYPE~Rfl|B|D|RD] 



[.CTL-MIS] 
[,RES**YjN] 
[,ECHO»Y|N] 
[, PARSE »Y|N] 



commandname 

is the name of the command or command list. 

MOD = modulename 

shows the name of the module that processes the command. NetView 
command modules begin with the letters aau, bnj, cnm, or dsi. For command 

lists, USeMOD = DSICCP. 

Note: When you define a user-written command procedure, be sure to specify 
a unique module name on the mod operand. Do not use a name that might be 
recognized by the system as a command, because NetView will attempt to 
execute that command instead of the user-written command procedure. 

TYPE = R|I|B|D|RD 

shows the command type. If ctl=s is used to define pa or pf keys, then type=i 
is required. 

Note: Do not define regular command procedures with type = i or type = b. 

R is a regular command. If type is not coded in the cmdmdl statement, 
type=r is assumed. Only one regular command runs at a time for an 
operator. If an operator enters a regular command while another regular 
command is running, the second command is held by NetView and runs 
after the first command is finished. Regular commands are allowed in 
command lists. This is the default. 
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I is an immediate command. An immediate command interrupts a regular 
command. Immediate commands are usually screen control or error 
recovery commands. When an immediate command is running, the key- 
board is locked and other commands cannot be entered. Immediate com- 
mands are not allowed in command lists or as initial commands. They 
also cannot be used with the ppt operand of the at, every, and after com- 
mands. 

B is a command that can run as either a regular or an immediate command. 
If an operator enters the command at a terminal, NetView treats it as an 
immediate command. If the command is in a command list, NetView 
treats it as a regular command. 

D is a data services command. Data services command procedures run 
under a data services task (dst). Because these commands are internal, 
operators cannot enter them at their terminals. Some internal commands 
that support the session and hardware monitors are type=d. 

RD is a regular or data services command. An example is the switch 
command. 

CTL-NJS 

controls whether the command is normal (n) or special (s). If ctl=s is used to 
define pa or pf keys, then type=i is required. 

N means that the command is normal, n is the default. 

S means that the command is special. Special means that pa or pf keys are 
defined as commands. For commands you want to be able to set to a key, 
you must use mod=dsipfk. 

Note: Do not use cmdmdl statements to define pf keys to regular 
command procedures. 

RES = Y|N 

specifies whether the command module is loaded when NetView is initialized. 
At initialization, when NetView loads only frequently used command modules, 
you save storage. However, if you load all command modules at initialization, 
performance can be degraded because less operating storage is available. 

Y means the command module is loaded at NetView initialization and 
remains resident in storage. Y is the default. 

N means the command module is not loaded until the command is run, and 
the storage that is used is freed upon completion. 

If the following commands are coded res=n, NetView automatically makes 
them res=y: 

• All vtam commands 

• dsiccp (command lists command processor) 

• AGAIN, BGNSESS, DSIYCLF, DSIYCTRM, DSIYOCRM, DSIYOFPM, DSIYOLRP, DSIYOMRP, 
DSIYOSRP, DSIYOTP, DSIYPIF, LOGOFF, REPLY, START, STOP. 

ECHO = Y|NO 

controls whether a command is echoed to the screen after an operator enters 
it. For commands in command lists, the setting for &control determines the 
echo status. type = i and type = b commands are not echoed after they are 
entered from a terminal. 
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Y means an entered command is echoed, y is the default. 
N means an entered command is not echoed. 

Notes: 

1. Code echo = n for all commands and command lists that invoke 
full-screen panel displays. 

2. Commands that are echoed to the screen are subject to message 
automation if they match the conditions in an if-then automation 
statement. 

PARSE -Y|N 

specifies whether to parse the message buffer. 

Note: This operand is recognized only by dst processing. 

Y means to parse the message buffer, y is the default. 

N means that the message buffer is not parsed, parse = n improves 

command processor performance for user-written command procedures 
that do not use the parse buffer pdb. For information on how to write 
command procedures, see NetView Customization: Using Assembler. 

Related Statements: cmoclass, cmdsyn, keyclass, parmsyn, valclass 



16 NetView Administration Reference 



CMDSYN 



CMDSYN Statement 



The cmdsyn statement allows you to define additional names for commands or 
command lists. This statement is coded in the dsicmd member of dsiparm. 

Multiple cmdsyn and parmsyn statements can follow each cmdmdl statement. The 
cmdsyn statements must follow all of the parmsyn statements for a cmdmdl; other- 
wise, the parameter synonyms for that cmdmdl are ignored, cmdsyn statements 
must also precede any cmdclass, keyclass, or valclass statements for the 
command. 

Notes: 

1 . Do not use the following as command synonyms: 

• A comma or a period 

• A name that begins with a percent sign 

• A name that is a vtam command 

• Another NetView command 

• A command in an application program that runs with NetView. 

2. NetView help is keyed to command names. Therefore, if you create a 
synonym, you must create help for that synonym. Refer to NetView 
Customization Guide for more information on writing help panels. 

3. The synonyms might not work as expected depending on the NetView compo- 
nent you are using. For example, you can assign the t synonym to the tara 
command using the cmdsyn statement; however, if you are inside the hardware 
monitor, you will execute the title command instead of the tara command. 



[label] CMDSYN synonym 



synonym 

is the new name for the cmdmdl statement that precedes this cmdsyn statement. 
The operator can use either the original command name or the new synonym. 
However, the system console operator must always use the original command 
name. 

Related Statements: cmdclass, cmdmdl, keyclass, parmsyn, valclass 
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CNMAUTH Statement 



The cnmauth statement defines the authorization requirements for the cnm data 
transfer sessions. This statement is coded in the member of dsiparm specified by 
the mem keyword of the task statement whose tskid is xxxxxluc (xxxxx is the 
NetView identifier specified by the domainid keyword of the nccfid statement). The 
precoded member used in samplib is dsiluctd. 

Note: This statement must be coded after the dstinit statement that defines dsilinit 
as the dst initialization exit. 



Itab&t ] CNMAUTH [ CTL - GLOBALI SPECIFIC ] 

[,MAXSESS»n] 



CTL = GLOBALJSPECIFIC 

defines authorization requirements for lu sessions. 

GLOBAL means there is no authority check when NetView establishes new 
cross-domain session monitor sessions. The system accepts any 
session initiation request, global is the default. 

SPECIFIC indicates that sessions are initiated and accepted only for specific 
lus. Specific lus are those that are defined on the cnmtarg state- 
ment. 

MAXSESS = n 

specifies the number of parallel sessions the NetView cnm data transfer task is 
authorized to establish with another NetView lu. The maximum value you can 
specify for maxsess is 65535. If you do not code the maxsess operand, NetView 
does not set a limit to the number of sessions in which it is the primary logical 
unit. 

Related Statements: cnmtarg, nccfid, task 
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CNMTARG Statement 



The cnmtarg statement defines authorized lu names for the cnm data transfer task. 
If you specify global on the cnmauth statement, NetView ignores the specific 
cnmtarg lu names specified in the cnmtarg statements. If you specify specific on 
the cnmauth statement, you need a cnmtarg statement for each remote NetView or 
nccf that communicates with this NetView. You define an lu name only if you need 
to start a session with that lu. 

You can use the persist keyword to specify whether a session between this 
NetView and a remote NetView or nccf is persistent. A persistent session is one 
that remains active regardless of the time elapsed between conversations between 
this NetView and a remote NetView or nccf. A non-persistent session is one that is 
terminated if it is inactive for longer than the value specified in the non-persistent 
sessions timeout interval in dsictmod. The default value of the timeout interval is 
zero. See NetView Installation and Administration Guide for information on 
changing the value of the timeout interval. 

This statement is coded in the member of dsiparm specified by the mem keyword of 
the task statement whose tskid is xxxxxluc. (xxxxx is the NetView identifier speci- 
fied by the domainid keyword of the nccfid statement.) The precoded member used 

in SAMPLIB iS DSILUCTD. 

Note: This statement must be coded after the dstinit statement that defines dsilinit 
as the dst initialization exit. 



llabel] CNMTARG LU =luname 

[.PERSIST -YESjNO] 



LU = luname 

is the 4- to 8-character appl name for the remote cnm data transfer task, cnm 
data transfer tasks are named xxxxxluc, where xxxxx is the NetView identifier 
of the NetView where the cnm data transfer task runs. You can have multiple 
cnmtarg statements. To view session data from another NetView, you must be 
authorized by that NetView. 

PERSIST = YES|NO 

defines whether a session between this NetView and a remote NetView or nccf 
is persistent. The default value is defined on the persist parameter of the 
dstinit statement. The default on dstinit is persist=yes. 

YES means that the session is persistent and remains active regard- 

less of the time elapsed between conversations between this 
NetView and a remote NetView or nccf. 

NO means that the session is non-persistent and will terminate if the 

time elapsed between conversations between this NetView and a 
remote NetView or nccf reaches ctm_msgact_intvl seconds. 

Related Statements: cdrmdef cnmauth, domains, lu, nccfid, task * 
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COS Statement 



The cos statement defines equivalent names for duplicate class of service (cos) 
names in an interconnected network. This statement is coded in the members of 
dsiparm specified in the aliasmem statement. The precoded member used in 

SAMPLIB iS OSIALTAB. 



[label ] COS targname,targnet,origname 



targname 

is the cos name that applies to the target network. This name is also called the 
equivalent name because it becomes equivalent to the cos name in the origin 
network. 

targnet 

is the 1- to 8-character name of the network in which the cos is known by its 
equivalent name. 

origname 

is the name the cos is known by in the origin network. 

Related Statements: aliasmem, orignet 
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CTL Statement 



The ctl statement specifies the number of wrap count statements (www) and ratio 
statements (rrr) that follow. This statement is closely associated-with two other 
statements: w and r. The w statement defines the initial wrap values. The r state- 
ment defines the ratio values. 

This group of statements contains input data for bnjapama and establishes initial 
wrap counts and user alert thresholds. This statement is coded in the member of 
dsiparm specified by the mem keyword of the task statement whose tskid is 
bnjdserv. The precoded member used in samplib is bnjmbdst. 

Note: This statement must be coded after the dstinit statement that defines 
bnjapama as the initialization exit. 



I {label 1 CTL www rrr 

www 

defines the number of wrap count statements you need to code after the ctl 
statement. 

Note: This value must be a 3-digit number. Use leading zeros if necessary. 

rrr 

defines the number of ratio statements you need to code after the ctl state- 
ment. 

Note: This value must be a 3-digit number. Use leading zeros if necessary. 
Related Statements: dstinit, r, task, w 
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DEFFOCPT Statement 



The deffocpt statement defines the focal point nodes for a given NetView hardware 
monitor. Focal point alert support makes centralized problem determination easier 
by providing centralized alert notification. If more than one deffocpt statement is 
coded, the last one is used. 

Note: This statement is valid only in the dsicrttd initialization member. 



[/a&e/] DEFFOCPT PRIMARY= node/rame | 

[,BACI€UP»/70cfcmame2 ] 



PRIMARY - nodename 

the eight-character name of the luc task of the primary focal point, luc tasks 
are named xxxxxluc, where xxxxx is the NetView identifier of the NetView in 
which the luc task runs. 

BACKUP=nodename2 

the eight-character name of the luc task of an optional backup focal point, luc 
tasks are named xxxxxluc, where xxxxx is the NetView identifier of the 
NetView in which the luc task runs. 

Note: If a primary focal point is not active and a backup focal point is active, the 
backup focal point will become the primary focal point. 

Related Statements: None 
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DOMAINS Statement 



The domains statement allows the setup of cross-domain communication for opera- 
tors with specific control. This statement is coded in the operator's profile. It 
shows which cross-domain sessions this operator can start. This statement is 
coded in the member specified by the profilen statement associated with the oper- 
ator. Refer to "OPERATOR Statement" on page 70 and "PROFILEN Statement" on 
page 80 to determine how a profilen statement is associated with an operator. 



ftede/] DOMAINS tiomainid [,...] 



domain id [,...] 

is a 1- to 5-character identifier of a NetView or nccf in another domain, where 
this operator can start a cross-domain session. The NetView identifiers are 
coded on the nccfid definition statements for the other domains. 

The domains statement can be used as many times as necessary to define all the 
required domains. The domains statement is ignored if either auth ctl=global or 
options verify = minimal is specified. 

Related Statements: auth, cdmnsess, nccfid, operator, options, profilen 
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DSTINIT Statement 



The dstinit statement defines the initialization parameters required by optional 
data services tasks (dst). This statement is coded in the members of dsiparm spec- 
ified by the mem keyword on the task statements where mod=dsizdst. The pre- 
coded members used in samplib are: aaucnmtd, aauprmlp, bnjmbdst, BNJ36DST, 

DSIALATD, DSIAMLTD, DSICPINT, DSICRTTD, DSIELMEM, DSILOGBK, DSILUCTD, OSITRCBK, and 
USRSQMEM. 



[label J DSTINIT [FUNCT= VSAM|CNMI|BOTJi|OTHER ] 

E.PBSDN-name] 
E,PDDNM-nam#} 
E, UNSOL*- name ] 
[ ,PP ASS ** password ] 
E»SBSDN»name] 
E,SDDNM«name] 
[ ,SP ASS ^password J 
vv'^-- ;; -' E»DSRBU"»/inn|5} 
E,DSRBO-n/in|3J 
[ ,XITBN- modname ■■[,...]] 
[ ,XITBO*» modname E»—]J 
E ,XITDI» modname E.—31 

E.XITCO -modname Er—]] 
E ,XITCI » modname E»— ]] 
E ,XITVN» modname E»-]3 
E .XITVI- modname t,...Jl 
E f XITVO" modname E,..] J 
E .XITXI.- modname E,.»] J 
[,MACRF = NSR|LSR|DFR] 

E ,PERSlST=YES|NO! 
E .RETRY=YES|NG] 



FUNCT - VSAM|CNMI|BOTH|OTHER 

specifies the task function. Do not code multiple dstinit statements with con- 
flicting funct definitions. 

VSAM shows that the task is to use vsam only, unsol is ignored if vsam 

is specified, dsrbu is set to if vsam is specified. 

CNMI specifies that this task will send and receive cnm data to and from 

the network only, unsol need not be specified unless unsolicited 
cnm data is to be processed by the dst. A primary data set need 
not be specified. 

BOTH specifies that the task is to send and receive cnm data to and from 

the network and use vsam. 

OTHER specifies that this task does not use vsam or CNMservices. For 

example, this operand is used for the vtam lu task or to define a 
sequential log task, dsrbu is ignored, if it is specified, and is set 
toO. 

PBSDN = name 

is the 1- to 8-character dd or filedef name of the primary data set to be used by 
NetView sequential log services. For vm, the name is 1- to 7- characters. You 
must enter this name on a dd or filedef statement when you start NetView or 
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anytime before starting the sequential log tasks through the NetView allocate 
command or the vm filedef command. This keyword should only be specified 
once in each sequence of dstinit statements if you use NetView sequential log 
services. The pbsdn keyword is required for sequential logging and causes 
NetView to define the task as a sequential task. 

PDDNM = name 

is the 1- to 8-character dd name of the primary data set to be used by vsam ser- 
vices. For vm the name is 1- to 7-characters. You must enter this name on a dd 
statement when you start NetView. Specify pddnm at least once in each 
sequence of dstinit statements if you use vsam. 

UNSOL = name 

is the 1- to 8-character verb that is the label of the cmdmdl statement for the 
data services command processor (dscp) that gains control when unsolicited 
cnm data is received from the network, or passed to the dst by the cnm router 
subtask (dsicrtr). 

PPASS - password 

is a 1- to 8-character vsam password to be used when the primary data set acb 
is opened. This password must match the updpw parameter in the primary 
vsam data base allocation. 

SBSDN- name 

is the 1- to 8-character dd or filedef name of the secondary data set to be used 
by NetView sequential log services. For vm, the name is 1- to 7-characters. 
You must enter this name on a dd or filedef statement when you start NetView 
or anytime before starting the sequential log tasks through the NetView allo- 
cate command or the vm filedef command. This keyword should only be speci- 
fied once in each sequence of dstinit statements if you use NetView sequential 
log services. The sbsdn keyword is not required for sequential logging. 

SDDNM = name 

is the 1- to 8-character dd name of the secondary data set to be used by vsam 
services. For vm, the name is 1- to 7- characters. You should define this name 
on a dd statement when you start NetView. 

SPASS = password 

is the 1- to 8-character password to be used when the secondary data set acb 
is opened. This password must match the updpw operand in the secondary 
vsam data base allocation. 

DSRBU = nnn|5 

is a decimal number from through 999 that specifies the number of data ser- 
vices request blocks (dsrbs) to be pre-allocated for processing unsolicited 
problem determination request units (rus). The default value is 5. 

Note: If the task is an luc, am/lu, dsitrace, or dsilog, NetView sets dsrbu to 0. 

DSRBO - nnn\3 

is a decimal number from 1 through 999 that specifies the projected number of 
concurrent user requests for services from this dst. The value represents the 
number of dsrbs to be pre-allocated for processing solicited rus and vsam 
requests. If more requests are received than there are dsrbs available, the 
requests are queued. The default value is 3. 
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Notes: 

1. If the task is an luc, am/lu, dsitrace, or dsilog, NetView sets dsrbo equal to 
1. 

2. If the task is dsicrtr (router), the default in the cnmsoosz sample is 5. 
However, this value may need to be increased as indicated in the CNMS0057 
sample. 

The following operands that begin with xit are 1- to 8-character load module names 
for user-written exit routines for this dst. You can code up to 10 module names for 
each exit. These modules receive control in the order they are coded in the dst. 

XITBN - mod/7ame[,...] 

receives control when a sequential log data set is opened for output proc- 
essing only (not for a resume). This exit allows you to put an initialization 
record into the file. 

XITBO - moo7?ame[,...] 

receives control before each NetView sequential log services record is blocked 
for output, xitbo can only use the service facilities available to a dst sub-task 
defined as funct=other, excluding the dsiwls macro. 

XITDI - modname[,...~\ 

receives control as each dst initialization parameter is read. This exit routine 
processes statements following this statement only, dstinit xitdi must precede 
any statement that is to be processed by the dst initialization exit. 

XITCO » moo7?ame[,...] 

receives control for cnm interface output processing before the request is 
passed to vtam. 

XITCI «■ modnamel, . . . ] 

receives control for cnm interface input processing before data received is 
passed to the dscp. Specify this parameter under the dsicrtr subtask for 
access to unsolicited cnm data prior to NetView internal routing. 

XITVN - modname[,...] 

receives control when an empty vsam data set is opened for processing. This 
exit allows you to put an initialization record into the file. If xitvn is not speci- 
fied, access method services (ams) must be used to start the data set. 

XITVI = modnamel, .. .] 

receives control on input from the vsam file before the input record is passed to 
the dscp. 

XITVO * modname[,...] 

receives control before output of a record to the vsam file. 

XITXL = modname\_,...~\ 

receives control before data is logged to an external log. If smf (mvs only) is 
not used, this exit can perform the necessary logging, xitxl receives control by 
coding the dsiwls macro with the extlog keyword. For vm, see dsielxit in the 
NetView samplib for an example of a user exit that logs data to a file. 
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MACRF = NSR|LSR|DFR 

specifies local resource sharing. Specify the option that meets the require- 
ments of your installation. 

NSR is the level of support provided in nccf. This is. the default. 

LSR enables the reclaiming of data and index buffers by keeping a 

pool of the most recently referenced records in storage. This is 
effective in reducing physical i/o. 

DFR extends lsr to defer writing of records, dfr defers the writing of a 

record until NetView forces it out, because buffer space is needed 
for a read. This further reduces i/o by minimizing writes. 

Note: If macrf=dfr is defined, do not use the mvs operator reset 
command to stop NetView because records that are deferred 
might not be logged, which corrupts the data base. Use the 
NetView close or close immed command instead. 

You can use dfr and lsr with the vsam Local Shared Resource (lsr) option, lsr 
is explained in the OS/VS Virtual Storage Access Method (VSAM) Program- 
mer's Guide. The possible values indicate the following: 

dfr = Buffer pool scanning and deferred writes 
lsr = Buffer pool scanning on input only. 

If you are not using lsr, do not code this statement. See the NetView Installa- 
tion and Administration Guide for more information about using the vsam lsr 
option with NetView. 

Note: NetView supports the lsr or dfr facility for the network log as well as 
the standard vsam support for cnm applications. Do not use lsr or dfr for the 
dsilog task if you wish to browse the network log. 

PERSIST = YES|NO 

defines the default for whether all sessions between this NetView and a remote 
NetView or nccf are persistent. For more information on persistent sessions, 
see "CNMTARG Statement" on page 19. Code this keyword in the member 
identified by the mem keyword of the task statement that has a taskid of 

XXXXXLUC. 

YES means that the sessions are persistent and remain active regard- 

less of the time elapsed between conversations between this 
NetView and a remote NetView or nccf. 

NO means that the sessions are non-persistent and terminate if the 

time elapsed between conversations between this NetView and a 
remote NetView or nccf reaches the non-persistent sessions 
timeout interval in dsictmod. 

Note: The persist parameter of the cnmtarg statement can override this 
default for specific lus. 

RETRY = YES|NO 

defines the default for whether an attempt to allocate a conversation between 
this NetView and all the domains specified by cdrmdef statements will be made 
every 10 minutes if the first attempt fails. Code this keyword in the member 
identified by the mem keyword of the task statement that has a taskid of 
dsiamlut. 

YES means the session monitor attempts to establish an initial conver- 

sation with the other domains once every 10 minutes. 
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NO means the session monitor attempts to establish an initial conver- 

sation with the other domains only once. 

Note: The retry parameter of the cdrmdef statement can override this default 
for specific domains. 

Related Statements: aliasmem, cdrmdef, cnmauth, cnmtarg, ctl, initmod, loginit, r, 

REPORTS, TASK, W 
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F (Filter) Statement 



The f statement lets you associate messages to the message indicator classes you 
defined with the a statement. Based on the tests you specify, a message indicator 
can be triggered at the authorized receiver. The netlog action of the if-then auto- 
mation statement can also be used to trigger message indicators. See "IF-THEN 
Automation Statement" on page 34 for more information. The f statement is used 
in the dsicnm member of dsiparm. 

Notes: 

1. Messages DS15311, DSI559I, DSi546i, and DSI547I are routed to all NetView operators 
who are logged on. If an operator is in a terminal access facility (taf) session 
when a message is sent, the message is not sent to the operator's screen until 
the taf session is exited. At that time, the filter and alert in the status monitor 
is set off. Depending on how much time has elapsed while the operator was in 
the taf session, the circumstances under which the message was issued may 
have changed and the message may no longer be relevant. 

2. When the vtam function msgmod=on is coded, vtam inserts a five-character 
module name into all ist messages between the message number and the 
message text. If msgmod is coded as on, the f statements you code for ist mes- 
sages will have unpredictable results. 

Code as many f statements for each message as you like. You can code f state- 
ments only for message indicator classes 1 through 4. 



F class msgnum &e operator * string ' 
F continuation expressions 



or 



F class msgnum modname &e operator * string * 
F continuation expressions 



is the statement name and must be in column 1. 

class 

is the message indicator class number and must be from 1 through 4. This 
value must be in column 5 of the statement. This number corresponds to the 
class number on the a statement. 

msgnum 

is the first parsed element of a message (&1). This value must begin in column 
7 of the statement. 

Note: You can code as many f statements for a message number as you 
require. NetView classifies the message based upon the first true f statement 
for the message number. A single f statement can contain several comparison 
expressions. Comparison expressions are separated by commas. All of the 
comparisons on a single f statement must be true for the classification to be 
made. 
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&e 



the element selected for comparison to string. The expression must be located 
in columns 16 through 72. If the expression must continue onto successive 
lines, make a comma the last character on a line. 

&D Domain identifier 

&0 Operator identifier 

&T Time (hh:mm:ss) 

&M The hdrmtype f rom dsitib. See NetView Customization: Using Assembler 

for more information on the message header type. 
&n The number of the element as parsed by NetView. This number must be 

from 1 to 255. &1 is the message number. 

operator 

the logical symbol used to determine the relationship between &e and string. 
The following logical symbols are allowed: 

= &e is equal to string. 

96 &e is not equal to string. 

> &e is greater than string. 

-i> &e is not greater than string. 

< &e is less than string. 

-i< &e is not less than string. 

'string • 

the value or string you want compared with &e. 

continuation expression 

the continuation of an expression from the preceding line. Begin the continua- 
tion statement with an F and then continue the expression in columns 16 
through 72. 

modname 

the name of an optional module that processes &e and returns a value that 
NetView will compare to string, modname must begin in column 16. 

NetView is delivered with the module cnmfangc, which returns a one-character 
string that represents the type of node. The type of node depends on the value 
of &e. You can write other modules to meet your needs or use cnmfangc or 
both. Your module or cnmfangc is invoked with the following registers: 

REG1 Address of a parameter list 

REG13 Address of the caller's save area 

REG14 Return address of the calling program 

REG15 Entry-point address of modname. 
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The parameter list passed in regi contains five addresses: 



Word 


Address 


Description 


1 


MVTADDR 


The mvt address. 


2 


TXTPTR 


The address of &e. ~ 


3 


TXTLEN 


The address of a one-byte field containing the length 
of &e. 


4 


RESPTR 


The address of the field containing the result of 
modname processing. (For cnmfangc, this is one of 
the node types described in the following table.) 



RESLEN 



The address of a one-byte field containing the length 
of the result (pointed to by resptr). This word is set to 
the length of string and cannot be altered, (cnmfangc 
uses this word to blank out resptr before putting any- 
thing in it.) 



As an example, cnmfangc takes &e (a node name) and converts it to one of the 
following one-character node types: 



H Host 


E Local pu 


N ncp major node 


D Local lu 


L Line 


B Application major node 


C pu/cluster 


A Application minor node 


T LU/terminal 


Y cdrm major node 


S Switched major node 


Z cdrm 


R Switched pu 


W cdrsc major node 


Q Switched i_u 


X cdrsc 


F Local major node 


BLANK No node found 



This result is then compared to string to determine if an alert should be set up. 
Related Statements: a, if-then 
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HARDCOPY Statement 



The hardcopy statement designates the devices that can be used for hard-copy 
printers, it is used in the dsidmn member of dsiparm. 

[/a£>e/] HARDCOPY devicename [»...] 



devicename [,...] 

specifies the name of the printer as it is defined to vtam. This name can be 1- 
to 8-characters long. 

Use as many hardcopy statements as you need to define all your hard-copy 
printers. 

Although each operator can be assigned to only one hard-copy printer, several 
operators can share the same one. However, if too many operators share the 
same hard-copy printer, messages for that printer can accumulate and might not 
be printed for some time after they are received. 

Related Statements: None 
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HOLDMSG Statement 



The holdmsg statement is not needed for NetView Release 3. This statement 
causes NetView to hold the message on the operator's screen. Jf the message you 
are trying to hold is part of a multi-line write-to-operator (mlwto) message, 
holdmsg must identify the message that is the first line of the mlwto. The entire 
mlwto is held. 




Ipifce/i , ; , mowum ... <• msgid l^.J .- . 

msgid [,...] 

is a 5- to 8-character message identifier of a message from any product, 
command list, or user-written application that runs with NetView. 

You should not use the holdmsg statement in NetView Release 3. In NetView 
Release 1, this statement was used in the dsihmf member of dsiparm. The dsihmf 
member of dsiparm is not needed in NetView Release 3. Once you have started 
NetView, changes to the dsihmf member of dsiparm will not go into effect until you 
start NetView again. 

The holdmsg statement is supported in NetView Release 3 for compatibility with 
NetView Release 1. In NetView Release 3, the same function is provided by speci- 
fying hold(Y) on the if-then automation statement. For each message you want 
held, code a statement such as: 

IF MSGID= 'msgid' THEN HOLD(Y); 

where msgid is the message identifier. 

Note: The holdmsg statement holds a message for both the primary and sec- 
ondary message receivers. The if-then statement with just hold(Y) specified holds 
a message for the primary receiver only. To use if-then to hold a message for both 
primary and secondary receivers, specify exec route(all opids) and hold(Y) on the 
if-then statement, where opids is the list of primary and secondary message 
receivers. For example: 

IF MSGID='ABCD' THEN EXEC R0UTE(ALL 0PER1, 0PER2, +GRP1) HOLD(Y); 
Related Statements: if-then 
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IF-THEN Automation Statement 



The if-then statement allows you to specify the messages you want NetVlew to 
intercept and process without operator action. You can use this statement to code 
the conditions that must be met to select a message for processing, and the actions 
you want NetView to take if a message meets those conditions. You must write a 
separate if-then automation statement for each message or group of messages you 
want NetView to process automatically. 

You can store your if-then automation statements in one or more of the members 
you created in dsiparm. To activate if-then statement processing, you must issue 
an automsg command that specifies the dsiparm message automation member you 
want to use. This member becomes your active NetView message automation 
member and is compiled by the automsg command into a message automation 
table. For more information about NetView message automation members, see 
NetView Installation and Administration Guide. 

When NetView receives a message and message automation is active, NetView 
searches the active message automation table from the first statement to the last, 
looking for conditions that match the received message. NetView performs the 
then actions of the first statement that has if conditions matching the message. 
Once NetView finds if conditions that match a message, it stops searching the 
message automation table. Therefore, if you have more than one if-then auto- 
mation statement that could match a certain message, place the statements with 
more specific conditions earlier in the message automation member, followed by 
the statements with less specific conditions. 

Syntax Notes: 

1. You must code a semicolon (;) at the end of each if-then automation statement. 

2. You can use blanks to indent lines and to separate keywords, logical opera- 
tors, and parentheses. However, blanks used within a comparison string are 
valid characters in that string. 

3. You can continue an if-then automation statement on as many lines as needed, 
using columns 1 through 72. You can stop a line after any logical operator, a 
parenthesis, a completed comparison-expression, or an operand, and resume 
the statement anywhere in the first 72 columns of the next line. 

4. You must code all characters in an if-then automation statement in uppercase. 

5. It is recommended that comments be placed on separate lines for dsiparm 
members. Do not put comment lines between the beginning and end of a con- 
tinued if-then automation statement. When coding a comment line, the first 
column must contain an asterisk (*). 
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The format of the if-then automation statement is: 
> IF comparison-expressions THEN actions; 



IF Keyword 

You must code the if keyword at the beginning of each if-then automation state- 
ment. 

Comparison-Expressions 

NetView evaluates the comparison-expressions that you coded in the if portion of 
an if-then statement based on a received message. If the comparison-expressions 
are true, the actions coded in the then portion of the if-then statement are exe- 
cuted. 

If you want to take certain actions when NetView receives a multi-line 
write-to-operator (mlwto) message, your comparison-expressions must describe 
the first line of the message. The actions you specify apply to the entire multi-line 
message group. 

You can link multiple comparison-expressions together by using either a 
logical-and (&) or a logical-or (|) operator. When comparison-expressions are 
linked with the & operator, all of the linked comparison-expressions must be true. 
For example, the following if-then statement has two comparison-expressions 
linked with the & operator: 

IF DOMAINID='CNM01' & TEXT='PURGE DATE IS LATER THAN TODAV'S DATE' 
THEN EXEC (CMD('CLISTA') ROUTE (ONE * 0PER1)); 

For the comparison-expressions to be true, the message must originate in domain 
CNM01, and its text must be purge date is later than today's date. 

When comparison-expressions are linked with the | operator, any of the linked 
comparison-expressions must be true. For example, the following if-then state- 
ment has two comparison-expressions linked with the | operator: 

IF D0MAINID='CNM01' | TEXT='PURGE DATE IS LATER THAN TODAV'S DATE' 
THEN EXEC (CMD('CLISTA') ROUTE (ONE * 0PER1)); 

The comparison-expressions are true if the message originated in domain cnmoi or 
if its text is purge date is later than today's date. 

NetView evaluates expressions linked with & before those linked with |. For 
example, the following if-then statement has three comparison-expressions linked 
with | and & operators: 

IF D0MAINID=' CNMOI' | TEXT='PURGE DATE IS LATER THAN TODAV'S DATE' 
& SYSID='MVS' THEN EXEC (CMD('CLISTA') ROUTE (ONE * 0PER1)); 

When processing this if-then statement, NetView evaluates the text and sysid 
comparison-expressions first, because they are linked with the logical-and (&) 
operator, then evaluates the domainid comparison-expression. This means both the 
text and sysid comparison-expressions must be true or the domainid 
comparison-expression must be true. 
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You can control the order in which comparison-expressions are evaluated by using 
parentheses to group comparisons that you want evaluated together. If, in the pre- 
vious example, you want NetView to evaluate the domainid and text 
comparison-expressions first, code parentheses around them, as follows: 

IF (D0MAINID='CNM01' | TEXT='PURGE DATE IS LATER THAN TODAV'S DATE') 
& SYSID='MVS' THEN EXEC (CMD('CLISTA') ROUTE (ONE * 0PER1)); 

When processing this if-then statement, NetView evaluates the domainid and text 
comparison-expressions first, because they are grouped within parentheses, then 
evaluates the sysid comparison-expression. This means either the domainid or the 
text comparison-expressions must be true and the sysid comparison-expression 
must be true. 

The three kinds of comparison-expressions are: 

• Parse-function 

• Token-function 

• Bitstring-function. 

Parse-function Comparison-Expressions 

Use the parse-function comparison-expression to compare alphanumeric character 
strings. The format is: 

parse-name [(pos)~\ = J -,= compare-item 



parse-name 

The following parse-names can be used. These parse-names can also be 
assigned to a variable in the if portion of an if-then automation statement. The 
variable can then be used in the cmdstring parameter of the then portion of an 
if-then automation statement. See the explanation of the cmdstring parameter 
on page 42. 

DOMAINID 

indicates that you want to compare the NetView domain where the 
received message originated to compare-item. The compare-item 
is the 1- to 8-character name of a NetView domain. 

HDRMTYPE 

indicates that you want to compare the header type of the received 
message to compare-item. The compare-item is a 1 -character 
message header type. See the description of the bufhdr contol 
block in NetView Customization: Using Assembler for information 
on the possible values of hdrmtype. 

JOBNAME 

indicates that you want to compare the name of the mvs job where 
the received message originated to compare-item.- The 
compare-item is the 1- to 8-character name of an mvs job. job-name 
can only be used when executing NetView in an mvs environment. 

Because the jobname is the name of the job that originated the 
message, it may not always be the same as the name of the job to 
which the message is referring. For example, this can occur when 
mvs issues a message about the NetView job. Also, jobname can 
contain the name of an initiator (instead of the actual jobname) 
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MSGID 



SESSID 



SYSID 



TEXT 



IF-THEN 



when a job is started or terminated. If the message is issued during 
startup or termination, extract the job name from the message text 
rather than using the jobname variable. The value of jobname is 
null if the message is not received through the subsystem interface 

(SSI). 

indicates that you want to compare the message identifier of the 
received message to compare-item. The compare-item is a 1- to 
10-character message identifier. The message identifier of the 
received message is the first ten characters of the first token of the 
message. If a reply id is sent with the message, it is not used as the 
first token. 

indicates that you want to compare the identifier of the taf session 
from which the received message was sent to compare-item. The 
compare-item is a 1- to 8-characterTAF session identifier. 

indicates that you want to compare the identifier of the mvs system 
where the received message originated to compare-item. The 
compare-item is a 1- to 8-character mvs system identifier, sysid can 
only be used when executing NetView in an mvs environment. The 
value of sysid is null if the message is not received through the sub- 
system interface (ssi). 

indicates that you want to compare the text of the received 
message to compare-item, text contains the entire message text. 
The compare-item is a 1- to 255-character string. 



(pos) 



specifies the position within parse-name where you want the comparison to 
begin. The default value is 1. 



= indicates that parse-name must equal compare-item for the 
comparison-expression to be true. 

-i= indicates that parse-name must not equal compare-item for the 
comparison-expression to be true. 

compare-item 

The compare-item for domainid, hdrmtype, jobname, msgid, sessid, and sysid 
parse-names must be either a literal or a variable-name. The compare-item 
for the text parse-name can be any combination of literals, variable-names, 
and place-holders. 



literal 



an alphanumeric character string that is compared with the 
message you want checked for automatic processing. 
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Enclose a literal compare-item in single quotes. When using a 
single quote as part of the comparison string, code a second single 
quote following the first. For example, to compare a message such 
as: 

PURGE DATE IS LATER THAN TODAY'S DATE 

code the following: 

'PURGE DATE IS LATER THAN TODAY "S DATE' 

Do not substitute a double quote for two single quotes. 

The maximum length allowed for a literal compare-item is 255 char- 
acters. Try to keep literal compare-items on one line. If you must 
use multiple lines for a single compare-item, do not indent the con- 
tinuation lines. End each line in column 72, and begin each contin- 
uation line in column 1. 

You can also continue a literal compare-item by breaking it into 
smaller literal compare-items on multiple lines. Consecutive literal 
compare-items are concatenated without blanks being added, so 
you do not have to end the lines in column 72 and begin them in 
column 1. For example, you could continue a literal compare-item 
on multiple lines as follows: 

IF TEXT*' PURGE DATE IS LATER ' 
'THAN TODAY "S DATE' 

variable-name 

a variable name is used to designate part of the message informa- 
tion that NetView should skip over during comparison processing 
but store for later use during action execution. 

If you want NetView to skip over part of the message text during 
comparison processing, you can assign part of the text to a 
variable-name. The text that was skipped over is stored in the 
variable-name you specify and can be used in the cmdstring param- 
eter of the then portion of the if-then automation statement. 

For example, the following if-then statement contains the 
variable-name datevar: 

IF DOMAINID='CNM01' & TEXT='DATA BASE HASN"T BEEN PURGED SINCE' 
DATEVAR THEN EXEC (CMD('CLISTA' DATEVAR) ROUTE ALL OPERA OPERB); 

If NetView receives the following message: 

DATA BASE HASN'T BEEN PURGED SINCE 5/3/88 

then this statement says to do the following: 

1. Store the value of the text following the word since in the 
datevar variable 

2. Run CLiSTA under both opera and operb using the value of 
datevar as a parameter: 

CLISTA 5/3/88 

If you want NetView to use some other message information in the 
cmdstring parameter of the then portion of an if-then statement, you 
can assign the value of the following parse-names to a 
variable-name: 
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DOMAINID 

HDRMTYPE 

JOBNAME 

MSGID 

SESSID 

SYSID. 

For example, the following if-then statement contains the 
variable-name domid: 

IF TEXT=' PURGE DATE IS LATER THAN TODAV'S DATE' & DOMAIN ID=D0MID 
THEN EXEC (CMD('CLISTA 'DOMID) ROUTE ALL OPERA OPERB; 

If NetView receives the following message from domain cnmoi: 

PURGE DATE IS LATER THAN TODAY "S DATE 

then this statement says to do the following: 

1. Store the value of domainid in the domid variable-name. The 
value of variable domid becomes cnmoi. 

2. Run clista under both operators opera and operb using domid 
as a parameter: 

CLISTA CNMOI 

The maximum length of a variable-name is 16 characters. You can 
code up to 25 variable-names in any if-then automation statement 
using any name not also used in the same statement as a keyword, 
command name, or command list name. Do not use the same vari- 
able name more than once in any one if condition. 

place-holder 

a period (.) acts as a place holder and causes NetView to skip over 
part of the message text that does not need to be compared. The 
following if-then statement uses place-holders to cause NetView to 
skip over parts of the message text: 

IF TEXT = . 'SENSE C0DE=' SENSE . 

THEN EXEC (CMD('CLIST1 'SENSE) ROUTE ONE OPERA OPERB); 

If NetView receives the following message: 

RESOURCE LU1 SENSE C0DE=08 NOT ACTIVATED 

this statement says to do the following: 

1. Skip over all of the text preceding SENSE C0DE= 

2. Store the value '08' in the variable-name sense 

3. Skip over all of the text following the variable-name sense. 

NetView does not store text designated by a place-holder for later 
use. Use a variable-name compare-item to store text for later use. 

Notes: 

1. A period, coded within single quotes, is treated as the period 
character, not as a place-holder. 

2. A place-holder differs from a period used in an &if control state- 
ment in the NetView command list language. In an &if control 
statement, a period is used to avoid any problems that would 
occur if a variable has a null value. 
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Token-function Comparison-Expression 

The token-function comparison-expression is used to compare words and phrases. 
The format is: 



TOKEN (token-number Jpos]) - f -,= compare-item 



TOKEN 

instructs NetView to divide the message into tokens (words and phrases) 
before comparing it to compare-item. When comparing message text "token- 
by-token", NetView uses the blank space(s) between words and phrases to 
divide the message into tokens. All of the characters between two blank 
spaces equals one token. 

(token-number [pos]) 

token-number identifies the token in the message text that is to be compared 
to compare-item, token-number must have a numeric value. 
The default value is 1. 

pos identifies the position within a token of the message text where 

comparison with compare-item should begin, pos can be any 
number from 1 to 255. The default value is 1. 



— indicates that token-number must equal compare-item for the 
comparison-expression to be true. 

-i = indicates that token-number must not equal compare-item for the 
comparison-expression to be true. 

compare-item 

compare-item for a token-function can be a literal or variable-name and is 
coded the same as the parse-function compare-item. See the explanation of 
the compare-item parameter in the parse-function variable on page 37. 

The following sample if-then automation statement uses a token-function as its 
second comparison expression: 

IF DOMAINID= , CNM01' & TOKEN (5 3) -= '0PER1' THEN DISPLAY(N); 

This statement tells NetView that the message should not be displayed if it origi- 
nated in domain cnmoi and if its fifth token does not contain the operator identifier 
operi, beginning in position three. 

Bitstring-Function Comparison-Expression 

The bitstring-function specifies one or more routing or descriptor codes in the 
message that you want checked against your automatic processing criteria. The 
format is: 



bitstring-name Upos)} = J -,= bitstring 
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bitstring-name 

bitstring-name can be one of the following: 

ROUTCDE 

identifies one or more mvs routing code bits assigned to the 
message that should be compared with bitstring- A message can 
have up to 128 routing code bits. The value of routcde is null if the 
message is not received through the subsystem interface (ssi). 

DESC 

identifies one or more mvs descriptor codes assigned to the 
message that should be compared with bitstring. Each message 
has 16 descriptor code bits. The value of desc is null if the 
message is not received through the subsystem interface (ssi). 

See MVS System Programming Library: System Macros and Facilities, Vol. 2 
for more information on route and descriptor codes. 

(pos) 

when bitstring-name is routcde, pos specifies the message routing code bit 
where the bitstring comparison should begin. The pos parameter can be any 
number from 1 to 128. The default value is 1. 

when bitstring-name is desc, pos specifies the message descriptor code bit 
where the bitstring comparison should begin, The pos parameter can be any 
number from 1 to 16. The default value is 1. 

= indicates that bitstring-name must equal bitstring for the 
comparison-expression to be true. 

-i as indicates that bitstring-name must not equal bitstring for the 
comparison-expression to be true. 

bitstring 

bitstring can have any combination of the values 1, 0, and X. Enclose bitstring 
in single quotes. If bitstring-name is routcde, bitstring can be up to 128 char- 
acters long. If bitstring-name is desc, bitstring can be up to 16 characters long. 

A value of 1 in bitstring tells NetView to check that the routing or descriptor 
code bit has been assigned to the message, and a value of tells NetView to 
check that the code bit has not been assigned to the message. An X value tells 
NetView not to check the value of that routing or descriptor code bit in the 
message. For example, if you were checking for a bit string of 0X1, the bit 
strings 011 and 001 would both match. 

The following example if-then automation statement uses routcde and desc 
comparison-expressions: 

IF ROUTCDE (3) = '10011' | DESC (6) = '110' 

THEN EXEC (ROUTE (ALL 0PER1 0PER4 0PER6)) BEEP(Y); 

This statement tells NetView that when the message routing code has the numbers 
10011 starting in the third position or when the message descriptor code has the 
numbers 110 in positions 6 to 8, then the message is routed to the operators whose 
identifiers are operi, oper4, and oper6, and an audible alarm is sounded on their 
terminals when the message is displayed. 
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THEN Keyword 



The then keyword defines the actions in each if-then automation statement. 



Actions 



Execute-Actions 



In the then portion of an if-then statement, you can specify one or more actions for 
NetView to take when the if conditions of the if-then statement are true. The two 
kinds of actions are: 

• Execute-action 

• Yes-or-no-action. 



An execute-action is one or more executable actions. You can code multiple 
execute-actions on a single if-then automation statement. The format is: 



EXEC itCMOicmdstring)} (TtOUTECrot/teparms)]} 



EXEC 

tells NetView to execute the following actions. Either cmd or route or both can 
be specified with each exec. You can specify exec more than one time in a 
single if-then statement to execute multiple commands and route multiple 
copies of the message. 

CMO 

tells NetView you want a command or command list executed. 

(cmdstring) 

contains the complete command syntax of the command or command list. The 
command and any literal parameters must be enclosed in single quotes. Any 
variable-names you want to use as parameters must be outside the single 
quotes. Any delimiters that need to be included in the command string also 
need to be enclosed in single quotes. For example, in the following 
execute-action: 

EXEC (CMDCCLISTB ' VARPARM ' ' VARPARM2 ' LITPARM')) 

a space is included within the single quotes after clistb to delimit the varparm 
variable-name. A space is enclosed in single quotes between varparmi and 
varparm2 to delimit these two variable-names. Also, a space is included within 
the single quotes before the litparm literal parameter. If the value of varparmi 
were0PER4 and the value of varparm2 were opers, this example would execute 
as: 

CLISTB 0PER4 0PER5 LITPARM 

For information on passing variables from the if portion of an if-then statement 
to a command or command list, see the parse-function section on page 36. 

ROUTE 

instructs NetView to route the cmdstring or the message to the operators 
whose identifiers are specified in routeparms. route enables you to route the 
cmdstring or message to different tasks. 

Note: See NetView Customization: Writing Command Lists for information on 
the msgroute command, msgroute can be used when you need to check the 
value of global variables or the message text of a line other than the first in a 
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multi-line write-to-operator message before deciding where to route the 
message. 

(routeparms) 

specifies the operators or groups of operators to whom the message or 
cmdstring should be routed for processing. The format is: ~ 



I ONE|ALL [*] [PPT] Joper[,...]] [+fif/p[,...]] 

Note: At least one operand must follow either one or all. 

ONE|ALL 

ONE means the cmdstring or message is routed to the first operator in 
the list who is logged on to NetView or to the first logged-on oper- 
ator assigned to the group if a group appears in the list. 

ALL means the cmdstring or message is routed to all the operators 

and groups of operators in the list who are logged on to NetView. 

* 

means the cmdstring or message is routed to the current operator task (the 
task where the message is intercepted for automation checking). 

PPT 

means the cmdstring or message is routed to the ppt task for processing. 

oper [,...] 

the identifier of the operators to whom the cmdstring or message should be 
routed. The operator identifier must be defined to NetView with an oper- 
ator definition statement (see "OPERATOR Statement" on page 70). The 
maximum length of an operator identifier is 8 characters. You can code as 
many operator identifiers as needed. 

+grp [,...] 

the identifier of the groups of operators to whom the cmdstring or message 
should be routed. The maximum length of a group identifier is 8 charac- 
ters, and it must begin with a plus (+) sign. You can code as many group 
identifiers as needed. Define group identifiers with the assign command. 
See NetView Operation for more information about the assign command. 

The following example if-then automation statement has two execute-actions: 

IF MSGID='AAU000r THEN 

EXEC (ROUTE (ALL * 0PER1 0PER2) 

EXEC ( CMD (' CLISTI') ROUTE (ONE 0PER3 0PER4); 

When message aauoooi is received, copies of the message are sent to the current 
operator task, operi, and OPER2. clisti is executed under OPER3 if OPER3 is logged 
on to NetView. If OPER3 is not logged on to NetView, clisti executes under oper4 if 
0PER4 is logged on. 

Notes: 

1. It is recommended that when you specify cmd on an exec, that you also specify 
route. If an exec specifies cmd but not route, where NetView executes the cmd 
action is determined as follows: 

• If message automation is invoked under an ost, the cmd action is executed 
under that ost. 
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• If message automation is invoked under the ppt, the cmd action is executed 
under the ppt. Message automation is invoked under the ppt if one of the 
following types of messages are received for which no assign pri is in 
effect and no authorized receiver is logged on: 

- Unsolicited vtam messages 

- Authorized receiver messages 

- Command output of commands running under the ppt 

- Messages originating in the ppt task 

- Messages queued to the ppt task. 

• For messages that are unsolicited, unassigned, and received over the sub- 
system interface (ssi), the following happens: 

- If cnmcssir (the ssi router task) was started by a start command, the 
cmd action is executed under the task that started cnmcssir. Therefore, 
you should always start cnmcssir from an autotask and not the ppt or a 
regular ost. 

- If cnmcssir was started by the init=y parameter of the task statement, 
the cmd action is not executed, and the message is discarded. There- 
fore, you should never use init=y on the task statement for cnmcssir. 

2. If an exec specifies route but not cmd, NetView routes the message to the oper- 
ators specified in routeparms, using the beep, display, hcylog, and hold 
yes-or-no-actions specified in the if-then statement. See "Yes-Or-No-Actions" 
for information about yes-or-no-actions. 

3. If an exec specifies both cmd and route, NetView executes the cmd actions 
under the operators specified in routeparms. Commands cannot be routed to 
sysop or the NetView log. 

NetView executes the beep, display, hcylog, and hold yes-or-no-actions under 
the current operator task. 

route does not provide any portion of the message to the cmdstring parameter. 
Use the parse-names from the if portion of the statement to pass message 
information to the cmdstring parameter. 

Yes-Or-No-Actions 

The yes-or-no-actions are actions, which you specify, for NetView to take when the 
if conditions of an if-then statement are true. The format is: 



action-name(Y\H} 



action-name(Y\N) 

You can code each action-name only one time for an if-then statement. Once 
an action-name is specified, it cannot be changed for different execute-actions. 
An action-name can be one of the following: 

BEEP 

determines whether an audible alarm sounds when the message is 
displayed (see note 2). If beep is not specified, the default value is 

BEEP(N). 

DISPLAY 

determines whether the message is displayed (see note 2). If 
display is not specified, the default value is display(Y). 
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HCYLOG 

determines whether the message is placed in the hardcopy log (see 
note 2). If hcylog is not specified, the default value is hcylog(Y). 

HOLD 

determines whether the message is held on the operator's screen 
after it is displayed (see note 2). If hold is not specified, the default 
value is hold(N). Some messages can already have a hold attribute 
attached to them. If you code a hold action-name for these mes- 
sages, the hold action-name overrides the attached hold attributes. 
If you do not code a hold action-name for these messages, their 
attached hold attributes are used instead of the NetView hold = no 
default. 

NETLOG(N)|(Y [indicator-number] [*] loperl,...J] [+grp[,...]]) 

determines whether the message is placed in the NetView log and 
whether the message activates a status monitor important message 
indicator for specified operators or groups of operators. If netlog is 
not specified, the default value is netlog(Y). 

Note: The f (filter) statement may also be used to trigger impor- 
tant message indicators. See "F (Filter) Statement" on page 29 for 
more information. 

indicator-number identifies the status monitor important 

message indicator. 

* means the message is logged as important 

for the operator task that the message is 
routed to or the current operator task (the 
task where the message is intercepted for 
automation checking). 

oper [,...] the operator identifier of the operators for 

whom the message is logged as important. 
The operator identifier must be defined to 
NetView with an operator definition state- 
ment (see "OPERATOR Statement" on 
page 70). The maximum length of an oper- 
ator identifier is 8 characters. You can code 
as many operator identifiers as needed. 

+grp [,...] the group identifier of the groups of opera- 

tors for whom the message is logged as 
important. The maximum length of a group 
identifier is 8 characters, and it must begin 
with a plus (+) sign. Define group identifiers 
with the assign command. See NetView 
Operation for more information about the 
assign command. 

If the operator has not been in status monitor or log browse but is 
logged on, message CNM039I is displayed: 

CNMG39I AN IMPORTANT MESSAGE HAS BEEN LOGGED -. 
PLEASE BROWSE THE NETVIEW LOG. 

If only an indicator-number is specified, the message is logged as 
important for the authorized receiver. The following example 
shows how the if-then statement is coded withjpnly an 
indicator-number: 
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SYSLOG 



IF MSGID='ISTlG5r THEN NETL0G(Y 2); 

Message istiosi is defined as an important message with a status 
monitor important message indicator number of 2. When Net View 
encounters message istiosi, the message is logged as important for 
the authorized receiver. 

If an indicator-number and a list of operators or groups of operators 
are specified, the message is logged as important for the operators 
and groups of operators listed. The following example shows how 
message istiosi is logged when an indicator-number and a list of 
operators and groups of operators are specified: 

IF MSGID='IST105I' THEN NETL0G(Y 2 * 0PER1 +GRP5 0PER6); 

Message istiosi is defined as an important message with a status 
monitor important message indicator number of 2. When NetView 
encounters message istiosi, it is logged as important with defined 
highlighting for operi, oper6, all of the operators assigned to group 
+GRP5, and the current operator. If operator operi and opers are 
also assigned to group +grps, each operator receives only one 
copy of message CNM039I (if they have not been in statmon), and 
duplicate highlighting and logging do not occur. 

determines whether the message is placed in the mvs system log. If 
syslog is not specified, the default value is syslog(N). syslog has 
no effect on messages received from the subsystem interface (ssi). 
Messages received from the ssi are unconditionally placed in the 
mvs system log before being sent to NetView. syslog can only be 
used when executing NetView in an mvs environment. 

For an example of the coding for yes-or-no-actions, see the sample if-then state- 
ments shown on page 40. 

Notes: 

1. If route is specified but not cmd, NetView routes the message to the operators 
specified in routeparms using the beep, display, hcylog, and hold 
yes-or-no-actions specified in the if-then statement. Otherwise, NetView exe- 
cutes the beep, display, hcylog, and hold yes-or-no-actions under the current 
operator task (the task where the message is intercepted for automation 
checking). 

2. NetView processes hold and beep actions only when display(Y) is coded, hold 
and beep do not work for messages routed to an mvs console. 

3. A yes or no setting for display, hcylog, netlog, or syslog on the override 
command overrides the settings specified for these actions on the if-then state- 
ment. A disable setting for beep or hold on the override or defaults command 
means the settings specified in the if-then statement for these actions are not 
used. See NetView Operation for more information on the override and 
defaults commands. 

4. You can code yes or y for yes, and no or n for no. 
Related Statements*, alert, assign, f, holdmsg, operator 
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INITMOD Statement 



The initmod statement specifies the installation parameters to the session monitor. 
The statement is coded in the member of dsiparm specified by the~TASK statement 
whose tskid is aautsklp. The value of the mem keyword of the task statement iden- 
tifies the member of dsiparm that contains the initmod statements. The precoded 
member used in samplib is aauprmlp. 

Note: This statement must be coded after the dstinit statement that defines aauinit 
as the dst initialization exit in aauprmlp. 

Note: A single initmod statement is also coded in the member of dsiparm specified 
by the task statement whose tskid is dsisvrt. 



f/ade/] 
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AAUICPEX 
AAUICPEX 

AUTHDOM - NONEJANIIdomam/d 
AAUINLDM 

AUTHORIZ- NONElANYJnef/d 
AAUINLDM MAXEND«/W7j100 
AAUINLDM BUFTYPE -SAW 
[.BUFSIZE - &>K|4K][,BUFNUM - ccc|2] 
AAUINLDM BUFTYPE -TRACE 
[.BUFSIZE -i>dKJ4K][,BUFNUM -ccc|2J 
AAUINLDM SAW- YESJNO 
AAUINLDM TRACELU- YES|NO 
AAUINLDM TRACESC- YESiNO 
AAUINLDM RTM - YESjNO 
AAUINLDM RTMDISP- YES j NO 
AAUINLDM 

LOG - YES|NO[ .SESSTATS - YESJNO ] 
AAUINLDM KEEPPIU«nnn|10 
AAUINLDM KEEPDISC- 77/7/7(250 
AAUINLDM KEEPRTM - n/wJIO 
AAUINLDM NETID » networkname 
AAUINLDM PERFMEM - membername 
AAUINLDM KEEPMEM "membername 
AAUINLDM LUCOUNT-n/7/7|16000 



AAUICPEX 

must be the first initmod statement. 

Note: This is the only initmod statement used for the task whose tskid is 

DSISVRT. 

AAUICPEX AUTHDOM - NONE|ANY|doma/n/d 

initializes cross-domain authorization. You can code as many of these state- 
ments as you require for your environment. The possible values of authdom 
indicate the following: 

NONE indicates that nobody is authorized to establish a cross-domain 

session with this NetView. 

ANY indicates that anyone can establish a cross-domain session with 

this NetView. 
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domainid indicates that anyone using the specified NetView can establish a 
cross-domain session with this NetView. 

The default is any. Specifying none provides security for both the sdomain and 
the trace with domain id commands. 

AAUINLDM AUTHORIZ - NONE IANYI nef/d 

specifies whether NetView operators in other networks can view session con- 
figuration and trace data collected by this NetView. As many as 255 authoriz 
statements can be coded. The values of authoriz have the following meaning: 

NONE means that no NetView operator in another network is authorized 

to view session configuration and trace data collected by this 
NetView. 

ANY means that NetView operators in all other networks are author- 

ized to view session configuration and trace data collected by this 
NetView. 

netid means that NetView operators in the specified network are 

authorized to view session configuration and trace data collected 
by this NetView. 

The default is any. Specifying none may not provide security in all configura- 
tions. 

AAUINLDM MAXEND = nnn|100 

specifies the number of concurrent requests for piu trace data, where nnn is the 
maximum number you can specify. The value of nnn may be from 1 through 
999; the default is 100. When the value of nnn is exceeded, you will receive 
message aauosii. If you receive the message frequently, increase the value of 
nnn. If the specified value is too low, an operator viewing the trace data might 
not see the most recent piu data from an active session. 

AAUINLDM BUFTYPE = SAW[,BUFSIZE = bbK\ 4K][,BUFNUM = ccc|2] 

are the number and size of session awareness (saw) data buffers. For bufsize, 
bbK can have values from 2K (K equals 1024) to 32K; the default is 4K. For 
bufnum, ccc can have values from 2 to 255; the default is 2. 

Note: Although buftype is specified with a keyword, it is a positional operand 
and must be specified first as shown. The other operands are keywords that 
can be specified in any order or omitted. 

AAUINLDM BUFTYPE = TRACE[,BUFSIZE = bbK| 4K] [,BUFNUM = ccc|2] 

are the number and size of piu trace data buffers. For bufsize, bbK can have 
values from 2K to 32K; the default is 4K. For bufnum, ccc can have values from 
2 to 255; the default is 2. 

Note: Although buftype is specified with a keyword, it is a positional operand 
and must be specified first as shown. The other operands are keywords that 
can be specified in any order or omitted. 

AAUINLDM SAW = YESI NO 

specifies whether session awareness (saw) data should be collected. If this 
statement is omitted, session awareness data is collected, beginning at 
NetView initialization time. 

YES indicates that session awareness (saw) data is collected, begin- 

ning at NetView initialization time. This is the default value. 

NO indicates that no session awareness data is collected until the 

enable command is entered. 
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AAUINLDM TRACELU - YES|NO 

specifies whether NetView should start tracing lu information at NetView 
initialization. 

YES indicates that lu-lu sessions are traced beginning at NetView 

initialization. 

NO indicates that no lu tracing occurs until the trace start command 

is entered. This is the default value. 

AAUINLDM TRACESC = YES|NO 

specifies whether NetView should start tracing sscp information at NetView 
initialization. 

YES indicates that NetView starts tracing sscp information at NetView 

initialization. 

NO indicates that NetView does not start tracing sscp information 

until the trace start command is entered. This is the default 
value. 

AAUINLDM RTM - YES|NO 

enables the NetView response time monitor function. 

YES indicates that NetView response time monitor function is enabled. 

NO indicates that NetView response time monitor function is not 

enabled. This is the default value. 

AAUINLDM RTMDISP = YES|NO 

specifies whether you can display your response times. 

YES indicates that you can display your response times. 

NO indicates that you cannot display your response times. 

Notes: 

1. This value overrides the value specified in the hardware configuration. 

2. The dsplyloc parameter of the pclass statement overrides this value. 

AAUINLDM LOG = YES|NO [,SESSTATS=YES|NO] 

specifies whether NetView writes records to an external log and whether the 
network accounting and availability function is active. The external log can be 
the smf log (mvs only). For vm, logging is made to a sequential cms file by way 
of a user-written exit routine. (The NetView samplib contains a sample routine 
you can use or modify for this purpose.) Valid combinations are listed in 
Table 2. 
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Table 2. Combinations of LOG and SESSTATS 



If you specify NetView writes to external log 

LOG = YES, • Response time data 

SESSTATS = YES • Configuration data 

• Accounting and availability data (session statistics) 

• Session start records 

• Session end records for any sessions with response 
time data monitoring. 

LOG = YES, • Response time data 

SESSTATS=NO . Configuration data 

• Combined session start-end records for any sessions 
with response time data monitoring. 

LOG = NO, • No session monitor data. This is the default. 

SESSTATS = NO 

See "DSTINIT Statement" on page 24 for additional NetView definition state- 
ments that are required for external logging. See Appendix A, "External Log 
Record Formats" on page 101 for the record formats NetView writes to the 
external log. 

AAUINLDM KEEPPIU = nw7|10 

is the number of piu trace data records to be kept in virtual storage for all ses- 
sions. This number can be from 1 through 999; the default is 10. The keeppiu 
value can be overridden by defining keep classes. You can also change the 
keeppiu value for an individual session by using the keep piu command. For 
more information on keep, see NetView Operation. 

AAUINLDM KEEPDISC = nw7|250 

is the number of discarded piu trace data records to be kept in virtual storage. 
This number can be from 1 through 999; the default is 250. 

AAUINLDM KEEPRTM = nw7|10 

is the number of response time collection periods that can be kept in virtual 
storage for a specific session. This number can be from 1 through 999; the 
default is 10. rtm keep counts can be changed only at initialization. 

AAUINLDM NETID - networkname 

is the 1- to 8-character name of this network. This name is required if you have 
an interconnected network and have not defined a netid to vtam. This name is 
also required if you are using vtam V2R1 in an interconnected network. 

See Network Program Products Planning for more information about intercon- 
nected networks and netid. 

You must be consistent in the manner in which you define netid in your 
network. Each NetView or nldm in a network must have the same netid, 
whether it is defined to NetView, to nldm, or to vtam. 

If your network is not an interconnected network, you can omit this statement 
from all NetViews and nldms in your network. 

AAUINLDM PERFMEM « membername 

is the 1- to 8-character member name for performance class definitions for 
response time monitor. If performance classes are defined, this statement 
specifies the member name that contains the pclass and mapsess definition 
statements. The member is in the dsiparm data set. 

Omit this statement if you do nor use NetView to collect rtm data. 
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AAUINLDM KEEPMEM = membername 

is the 1- to 8-character member name for keep class definitions. If keep 
classes are defined, this statement specifies the member name that contains 
the kclass and mapsess definition statements. The member is in the dsiparm 
data set. 

Omit this statement if you are not using keep classes. 

AAUINLDM LUCOUNT»nnn l16000 

is the number of logical units (lus) in this network. This is a performance 
tuning value, and need not be exact. The number can be from 1 through 
999999. The default is 16000. 

When you assign a value, be sure to include all lus owned by the local system 
services control point (sscp) as well as all lus owned by other sscps that can 
have session partners owned by the local sscp. 

Related Statements: dstinit, kclass, mapsess, pclass 
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ISPAN Statement 



The ispan statement sets up the initial span of control for the operator. The oper- 
ator can remove this span of control by entering the NetView stop command with 
the span operand. This statement is coded in the member of dsiprf specified by the 
profilen statement associated with the operator. Refer to "OPERATOR Statement" 
on page 70 and "PROFILEN Statement" on page 80 to determine how a profilen 
statement is associated with an operator. 

.... ... . . ... ...... . ,.,. ...... - ,. .,^j 

[[abet ] ISPAN spanname [,...]. i 



spanname [,...] 

is the 1- to 8-character name of the span. You can code as many span names 
and as many ispan statements as you need to specify all of your spans of 
control. The span names coded on ispan are associated with span names 
coded on the spanlist statement in NetView and the span operand in vtam. 

Related Statements: operator, profile, profilen, span, spanlist 
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KCLASS Statement 



The kclass statement defines keep classes. A keep class determines what data is 
kept for the sessions mapped into that keep class. A session is mapped into a 
keep class when the session starts (session awareness). Once a-session is 
mapped into a keep class, it remains there until the session ends. 

Code one kclass statement for each keep class you define. You can code as many 
kclass statements as you want. 

If you code kclass and mapsess statements, create a member in the dsiparm data 
set to put them in. The name for this new member must match the name coded on 
the initmod aauinldm keepmem = membername statement. The kclass statements 
must be the first statements in the member. 

The kclass and mapsess statements control the amount of session awareness data 
recorded. If you do not code any of these statements, data for all sessions is 
recorded according to the defaults for the kclass statement. 



cname KCLASS [SAW-YESjNO] 

[,KEEPPIU = /?W7j10] 



[ ,DASD - NO|YES([ .FAILURES ][ .DATA ] 

[ .B1NDFAIL ][ JNITFAIL ][ .RTMDATA ] 

[ .SESSFAIL ][ .SESSNORM ][ JRACDATA ])] 



cname 

is the name of the defined keep class. This name is used on one or more 
mapsess statements as the value of cname in the kclass parameter. The name 
must be from 1- to 8-characters long and must start in column one of the state- 
ment. This is a required parameter. 

SAW = YES|NO 

defines whether session awareness data should be kept for the sessions 
mapped into this keep class. 

YES keeps session awareness data. 

NO does not keep session awareness data. 

Session awareness data is always kept for sscp-sscp sessions and sscp-pu ses- 
sions. To ensure that session awareness data is kept for all sessions, 
including sscp-lu and lu-lu, specify saw=yes. To collect response time monitor 
data for lus attached to terminal control units equipped with the response time 
monitor feature, you must keep session awareness data for both sscp-lu and 
lu-lu sessions. 

Note: If you specify saw=no, init failure and bind failure data is still kept if the 
initfail and bindfail parameters are coded under the dasd keyword of the 
kclass statement. However, if saw is coded as no in the initmod statement, no 
session awareness data is kept. This applies to all session types as well as 
init failures and bind failures. 

Keep session awareness data for all cross-network sessions. This ensures 
that cross-network data retrieval functions work correctly. 
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KEEPPIU = /?W7|10 

determines the initial piu keep count for the sessions mapped into this keep 
class. The value of nnn must be from 1 through 999. The default is 10. Once a 
session is active, the number of pius kept for that session can be changed 
dynamically using the keep pius operator command. 

DASD = NO|YES 

defines the conditions under which the sessions mapped into this keep class 
are recorded to the vsam file. 

NO does not record sessions to the vsam file. 

YES records the following specified sessions to the vsam file. 

FAILURES records lu-lu sessions to the vsam file only when they end 
with an abnormal unbind reason code or when they fail to 

BIND. 

DATA records sessions to the vsam file only if there is some trace 

or rtm data to record with the session. 

BINDFAIL records sessions to the vsam file if there is a failure to bind 
(bind failure). 

INITFAIL records sessions to the vsam file if there is a failure to set 
up prior to bind flow (init failure). 

RTMDATA records sessions to the vsam file if there is some rtm asso- 
ciated with the session. 

SESSFAIL records sessions to the vsam file if there is an abnormal 
unbind reason code. 

SESSNORM records sessions to the vsam file if there is a normal unbind 
reason code. 

TRACDATA records sessions to the vsam file if there is some trace 
data associated with the session. 

Note: Sessions are always recorded when a force command is issued by an 
operator, regardless of how dasd is specified. See NetView Operation for addi- 
tional information about the force command. 

Related Statements: initmod, mapsess, pclass 
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KEYCLASS Statement 



The keyclass statement associates a command keyword with one or more scope 
classes. Operators who have these scope classes coded in an opclass statement 
in their profiles or who have global control (no opclass statements coded) can run 
a NetView command that uses this keyword. Code keyclass after the cmdmdl state- 
ment of the command to which it applies and before the next cmdmdl statement. 
This statement is coded in the dsicmd member of dsiparm. 



9yword\*sQW£ft f/ > . ; v KEYCLASS fscop0C/ass£,.»T] 



keyword\ - OTHER 

keyword specifies a keyword that is scope-checked for the command shown 
on the previous cmdmdl statement. If you renamed a command 
operand using parmsyn, you must use the original name on the 
keyclass statement. 

See Appendix D, "Command Keywords and Values that can be 
Scope Checked" on page 139 for a list of keywords and keyword 
values that can be scope checked. 

=« OTHER lets you check the scope for all other keywords that have not specif- 
ically been entered for a command. 

Note: You can code multiple keyclass statements, but - other can 
be coded only once and only on the last keyclass statement. 

scopeclass [,...] 

specifies a scope class that can use the keywords. Scope class must be a 
number from 1 through 2040. If no scope class is specified, any operator can 
use this keyword. 

Note: If you want to code the scope of commands for a keyword value, you must 
code the keyclass statement and the valclass statement. If you want the scope of 
commands for the keyword value and not for the keyword itself, code keyclass 
without any scopeclass. 

Related Statements: cmdmdl, opclass, parmsyn, valclass 
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LOGINIT Statement 



The loginit statement defines the initialization parameters for the network log, 
trace logs, and optional NetView sequential log(s). The autoflip parameter speci- 
fies whether NetView should automatically continue recording on the primary data 
set when the secondary data set becomes full. The resume parameter specifies 
whether to begin recording at the beginning of the primary data set or to start 
where the previous session left off. For the most efficient logging, define both 
autoflip and resume to yes. 

Note: If you allocate only one data set, logging stops when it is full. However, if 
you define a secondary data set, it is used automatically. 

This statement is coded in the members of dsiparm specified by the mem keyword of 
the task statement whose taskids are dsilog and dsitrace or by the taskids that are 
using NetView sequential log services. It must follow the dstinit statements in the 
member. The precoded members used in samplib are dsilogbk and dsitrcbk. 



tlabetj LOGINIT [ AUTOFLIP - YES|NO J 

f .RESUME = YES[NQ1 



label 

is the optional label for the loginit statement. This label identifies the state- 
ment in any related error messages. 

AUTOFLIP = YES|NO 

defines whether logging should continue on the primary data set when the sec- 
ondary data set is full. The value of this operand must be one of the following: 

YES continues writing at the beginning of the primary data set when the 

secondary data set is full. 

NO does not continue writing on the primary data set when the sec- 

ondary data set is full. 

RESUME = YES|NO 

defines whether logging should begin where it left off in either data set, or 
logging should start at the beginning of the primary data set. The value of this 
operand must be one of the following: 

YES resumes writing following the last entry recorded in the log data 

sets. 

Notes: 

1. resume = yes is not supported on vm. 

2. If you define resume=yes and autoflip=no, you might have to 
restart the network log or trace task due to full data sets, 
depending on where logging left off. 

NO begins writing at the beginning of the primary log. 

Related Statements: task 
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LU Statement 



The lu statement translates lu names in interconnected networks. It assigns alias 
names by which logical unit names in other networks are known in this network. 
This statement is coded in the members of dsiparm specified on Ihe aliasmem state- 
ment. The precoded member used in samplib is dsialtab. 



^JVafce/] ill targnamejargnettorignamelssscpname] 



targname 

is the real name of the logical unit as it is defined to the vtam in this domain. 

targnet 

is the 1- to 8-character name of the network where the logical unit is known by 
its real name. 

origname 

is the alias translation name for this logical unit. 

sscpname 

is the 1- to 8-character name of the sscp that owns the real logical unit in the 
targnet network, sscpname is optional. If you do not code sscpname, the sscp 
identifier is taken from the vtam cdrsc definition statement. 

Related Statements: aliasmem, orignet 
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MAPSESS Statement 



You can define a series of mapsess statements to describe sessions that are 
mapped into each performance or keep class. A session is mapped into a perform- 
ance or keep class when the configuration of that session matches all the parame- 
ters of a mapsess statement. A session can match more than one mapsess 
statement. If it does, it is mapped by the first matching mapsess statement. 

For interconnected networks, alias names are used for resources that are not in 
your local network. If you want to map resources not in your local network, you 
must specify the alias names instead of the real names on your mapsess state- 
ments. 

For sessions where er, vr, or tp data are not available to NetView, the session is 
assumed to match these parameters. 

This sequence of statements is in the member of dsiparm named on the initmod 
aauinldm perfmem= memoername or keepmem= membername definition statement. 



If abet ] MAPSESS PCLASS - cname 

[,PRI=pname J 
[ ,SEC "snam&J 
[,ER-n J 
[,VR»n] 

■■tJP-ffJ 
llabetj MAPSESS KCLASS** cname 



[,PRI -pname] 
'[, SEC **sname J 
[,ER»o] 
E,VR«n] 
■t.TP-nJ 



label 

identifies the mapsess statement (optional) in any related error messages. 

PCLASS » cname 

names the performance class, as specified on the pclass statement, to which 
sessions that match all the other mapsess parameters are assigned. This 
parameter is required. 

KCLASS = cname 

names the keep class, as specified on the kclass statement, to which sessions 
that match all the other mapsess parameters are assigned. This parameter is 
required. 

PRI "pname 

is the name of the primary end point of any session that matches this mapsess 
statement. If the desired primary end point is the sscp, use the name specified 
on the sscpname start option for vtam. If you have not specified an sscpname 
name, use vtam for the name of the sscp. If the pri operand is omitted, or if a 
pri=* is coded, all primary end point names match this mapsess statement. 
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SEC **sname 

names the secondary end point of any session that matches this mapsess state- 
ment. If the desired secondary end point is a cross-domain sscp, specify the 
cdrm name for this sscp. If the parameter is omitted, or if sec=* is coded, all 
secondary end point names match this operand. 

Note: The pri and sec names can be coded with special characters so that a 
group of primary or secondary end points match the same mapsess statement. 

To vary one character, use a question mark ("?"). For example, a?b matches 
any name that begins with a, ends with b, and has one character between, such 
as aab, abb, axb, and so on. a??b matches any name that begins with a, ends 
with b, and has any two characters between, such as aaxb. A character must 
always appear in the position of a "?"; that is, a?b would not be matched by ab 
because there is no character replacing the "?." 

To vary a string of characters at the end of a group of resources, use an 
asterisk (*). For example, tso* matches any name that begins with the letters 
tso, such as tsoxyz, TSOB2219, and so on. The * can be used only at the end of a 
character string. It cannot be used between characters. 

ER-n 

is the explicit route number required for a session to match this mapsess state- 
ment. If a value is coded, it must be from through 7. If the parameter is 
omitted, or if er=* is coded, all er values match this operand. 

VR = n 

is the virtual route number required for a session to match this mapsess state- 
ment. If a value is coded, it must be from through 7. If the parameter is 
omitted, or if vr = * is coded, all vr values match this operand. 

TP = n 

is the transmission priority required for a session to match this mapsess state- 
ment. If a value is coded, it must be from through 2. If the parameter is 
omitted, or if tp=* is coded, all tp values match this operand. 

Related Statements: kclass, pclass 
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MAXABEND Statement 



The maxabend statement specifies the number of times a given NetView operator 
terminal session or automation task can end abnormally and be reinstated after- 
ward by the operator. When the limit is exceeded for an operator terminal session, 
a second NetView operator must use either a move or start command to recover 
the session. The number of abnormal endings increases each time the operator 
enters the reset immed command. Issue a start, stop, or move command to reset 
the current count to 0. This statement is coded in the dsidmn member of dsiparm. 

Note: The maxabend statement does not affect optional tasks. 



nnnnn\2 

specifies the number of abnormal terminations allowed. You can set maxabend 
from to 32767. If you do not code maxabend, the default is 2. 

Related Statements: None 
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MAXLOGON Statement 



The maxlogon statement shows the maximum number of times NetView allows an 
operator to recover from an incorrect logon and try again before -the session with 
that terminal is ended. If the logon recovery limit is reached, the. operator must log 
on through vtam. This statement is coded in the dsidmn member of dsiparm. 

Note: maxlogon does not control the number of times an operator can recover 
from an error in the new password fields when the operator's password is changed. 
There is no limit on the number of times an operator can recover from an error in 
the new password fields. 



[/aoe/] MAXLOGON mnnn\% 



nnnnn\3 

is the number of logon attempts allowed before the session is ended. You can 
set maxlogon to any number from to 32767. If you do not code maxlogon, the 
default is 3. 

Related Statements: None 
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MAXSPAN Statement 




The maxspan statement tells NetVlew the number of span names allowed. NetView 
sets aside storage in a table for each span. It is used in the dsidmn member of 

DSIPARM. 



Uabet% MAXSPAN rmrmrife 



nnnnn\0 

specifies the maximum number of spans that NetView allows. This number 
should be a multiple of 8. If it is not, NetView will round maxspan up to the next 
multiple of 8. You can set maxspan to any number from to 32760. If you do 
not code maxspan, it defaults to 0. 

maxspan should be at least as large as the number of different span names on 
the spanlist operand definitions. If you do not make maxspan great enough to 
cover all spans, some of your span definitions might be ignored. However, to 
save storage, do not make the maxspan number greater than you need. 

Related Statements: ispan, span, spanlist 

For more information concerning vtam installation, refer to "Minor Node 
Definitions" on page 63. 
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Minor Node Definitions 



You can limit specific minor node resource names with span of control by coding 
the span operand in the following vtam and ncp definition statements: 

• vtam statements: appl, pu, lu, local, cdrm, cdrsc, group, line, cluster. To 
learn how to code these vtam definition statements, see VTAM Installation and 
Resource Definition. 

• ncp statements: group, line, cluster, terminal, comp, vterm, pu, lu. To learn 
how to code these ncp definition statements, see NCP-SSP Resource Definition 
Reference. 

These statements are used in the member of dsivtam that has the same name as 
the associated major node. 



minornodename statement operands 

SPANss(spa/iname [,..,]) 



minornodename 

specifies the minor node name for this resource. 

statement 

identifies the vtam or ncp statement that defines the resource. 

operands 

are other operands for vtam or ncp or both. 

SPAN=(spanname [,...]) 

specifies the span or spans that are to be included in the minor node resource. 

The number of spans defined with the span operand and the operands of 
spanlist must not exceed the value of the maxspan statement. Any excess 
spans are ignored. 

Note: To add span for minor node names, code a spanlist statement in NetView 
for the associated major node name. Once you define the span of control, there is 
no association between the major and minor nodes. They can be in different 
spans, or the major node may not be span-checked at all. If the major and minor 
nodes are both in the same spans, you must list the spans on both the spanlist 
statement and on the vtam span operand. 

Related Statements: maxspan, span, spanlist 
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MODE Statement 



The mode statement defines equivalent names for duplicate logon mode names in 
interconnected networks. This statement is coded in the members of dsiparm spec- 
ified on the aliasmem statement. The precoded member used in samplib is dsialtab. 

tfabef] MODE, targmme f targttet,origname I 



targname 

is the logon mode name that applies to the target network. This name is also 
called the equivalent name because the mode name becomes equivalent to the 
mode name in the origin network. 

targnet 

is the 1- to 8-character network name of the network where the logon mode is 
known by its equivalent name. 

origname 

is the name the logon mode name is known by in the origin network. 

Related Statements: aliasmem, orignet 
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MSGCMD Statement 



The NetView message table definition used by the command facility has changed 
since NetView Release 1. Instead of msgcmd statements, in NetView Release 3, 
if-tmen automation statements are required to define messages that drive 
command lists. A utility program is provided with the installation samples to 
convert NetView Release 1 msgcmd statements to the format required for NetView 
Release 3. For information about how to migrate NetView Release 1 msgcmd state- 
ments to NetView Release 3 if-then automation statements, see NetView Installa- 
tion and Administration Guide. For more information about automating messages, 
see Console Automation Using NetView: Planning and Console Automation Using 
NetView: Implementing. 

Related Statements: if-then 
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NCCFIC Statement 



The nccfic statement names a command or command list to be run automatically 
when NetView is initialized. Any messages from the command or command list 
are sent to the system operator's console. This statement is coded in the dsidmn 
member of dsiparm. 



llabel ] NCCFIC [Cmtext 



IC=texf 

specifies the command or command list to run automatically when NetView is 
started. The command or command list must be able to run under the primary 
poi task (ppt). 

For a list of commands that cannot be used with the ppt, see NetView 
Customization: Writing Command Lists. 

Note: The default nccfic statement coded in the sample dsidmn shipped with 
NetView is as follows: 

NCCFIC IC=CNME1034 DSIMSG01 

This invokes command list cnmeio34 with the parameter dsimsgoi. The parameter 
dsimsgoi is the name of the message automation table that will be in effect when 
NetView is initialized. If you wish to use another table, change the dsimsgoi param- 
eter to the name of the table you want to use. 

Related Statements: None 
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NCCFID Statement 



The nccfid statement specifies the application program identification of the 
NetView in this domain. This statement is coded in the dsidmn member of dsiparm. 



llabef] NCCFID >MAINID=ctoa 

[ ,DMNPSW«passivo«n 

[ 5UPPCHAR=su ] 

£4>ROP=XES|NO] _ 



DOMAINID=o*oma/n/d 

specifies the 1- to 5-character application program name to be used with a 
vtam acb for this NetView. This name should be unique throughout the 
network. 

For interconnected networks, all NetViews and nccfs in session with each 
other must have unique identifiers that cannot be alias names. 

DM NPSW=pass word 

specifies a password to be used for this NetView domain. If you do not code a 
password, the password becomes the same as the NetView identifier. 

SUPPCHAR—suppressionchar 

specifies a single character to be used by a NetView operator to prevent 
NetView from writing the command out on the terminal, hard-copy log, and 
network log. If this operand is not specified, NetView does not check for a sup- 
pression character. 

Do not use the following characters as suppression characters: 



A 


equal sign (=) 


B 


blank 


C 


period (.) 


D 


asterisk (*) 


percent (%) 


ampersand (&) 


comma (,) 


minus (-) 


>P = YESINO 





specifies whether NetView operator sessions end under certain conditions. 
For example, if you specify drop=yes and an operator who is logged on to a 
non-SNA remote device powers off and then on, NetView would end the oper- 
ator session. 

YES tells NetView to end the session, yes is the default. 

NO tells NetView to attempt session recovery. 

Related Statements: None 
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O MONIT Statement 



The o monit statement specifies whether status monitor tries to reactivate inactive 
nodes (other than major nodes, applications, and cross-domain resources) if an 
unsolicited vtam istiosi message is received by NetView. Nodes can be excluded 
from automatic reactivation as follows: 

• By flagging them with the nomonit operand on the statopt statement 

• By using the monoff command or the monit stop command to add them to the 
node reactivation exclusion list. 

The o monit option control statement in member dsicnm of dsiparm is shown below. 



O MONIT 



O MONIT 

controls automatic node reactivation. 

Related Statements: statopt 
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OPCLASS Statement 



The opclass statement defines the scope of commands for a NetView operator. 
Operators with opclass in their profile can run only commands, command oper- 
ands, and command lists that are defined with these scope classes or that are not 
restricted by scope of commands. If you do not code opclass, or if you have 
options verify=minimal coded in dsidmn, the operator can run any command. 

NetView will not allow an operator to log on if the scope class specified on the 
opclass statement is greater than the maximum scope class specified on all 
cmdclass, keyclass, and valclass statements. 

This statement is coded in the member of dsiprf specified by the profilen state- 
ment associated with the operator. Refer to "OPERATOR Statement" on page 70 
and "PROFILEN Statement" on page 80 to determine how a profilen statement is 
associated with an operator. The precoded member used in samplib is osiprofb. 



J7a*>©/ 3 OPCLASS scopeciass £,„.] 



scopeclass [,...] 

is a number from 1 to 2040 that represents a scope class. Start your scope 
classes from 1 and work up to save storage space. 

Related Statements: cmdclass, keyclass, operator, options, profilen, valclass 
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OPERATOR Statement 



The operator statement identifies each operator who can log on to this NetView or 
who can start a session with this NetView from a NetView in another domain. It is 
also used to define operator identifiers that can be started as automation tasks by 
the autotask command. The operator statement must come before its associated 
profilen statements. This statement is coded in the dsiopf member of dsiparm. 



opM OPERATOR PASSWORD=password 



opid 

is the 1- to 8-character value that identifies an operator. The operator identifier 
must be made up of the characters A-Z, the numbers 0-9 or the special charac- 
ters #, @ or $. Each operator must have a unique operator identifier. Also, 
you must code an operator statement for each operator identifier you want to 
use for an automation task. Do not use the names of hard-copy logs, terminals, 
or task identifiers as operator identifiers. The following words are reserved by 
NetView and cannot be used as operator identifiers: 

ALL, DPR, DST, HCL, LOG, 

MNT, NNT, OST, PPT, SYSOP, TCT. 

PASSWORD=password 

is the 1- to 8-character operator password. You must code a password, but the 
password is ignored if options verify=minimal is coded in dsidmn. The pass- 
word is also ignored if this operator identifier is used when starting an autotask 
using the autotask command. For operator identifiers set up specifically for 
autotasks, you can use the password to identify the operator as such. 

Related Statements: options, profilen 
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OPTIONS Statement 



The options statement describes the type of checking NetView does at logon. It is 
coded in the dsidmn member of dsiparm. If there is no options statement in dsidmn, 
verify=normal is assumed. 



label] 



OPTIONS VERIFY=MINI L|MAXIMUM 



VERIFY=MINIMAL|NORMAL|MAXIMUM 

defines the level of security that NetView checks at logon. 

MINIMAL ensures that the operator is defined to NetView and the operator 
is not already logged on. The password is not checked. The 
logon profile and any other logon parameters are ignored. Scope 
of commands and span of control are not used. The operator can 
enter any command and control all resources. 

NORMAL checks all logon parameters, including operator identification, 
password, hard-copy log name, and profile. The profile, which 
contains information about what the operator is allowed to do, 
lets you limit the commands and resources that the operator can 
use. 

MAXIMUM uses security software to check the operator identification and 
password. NetView checks the hard-copy log name and profile. 
This operand replaces the racf operand used by NetView 
Release 2. However, NetView Release 3 supports racf for com- 
patibility purposes. 

Note: You can use maximum with NetView installed on an mvs/xa 
operating system only. Also, you must have some form of secu- 
rity software installed (for example, racf). 

Related Statements: None 
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ORIGNET Statement 



The orignet statement defines the name of the network to which the lu, cos, and 
mode statements apply. This statement is coded in the members of dsiparm speci- 
fied on the aliasmem statement. The precoded member in samplib is dsialtab. 



ORIGNET networkname 



networkname 

is a 1- to 8-character name of the network requesting the translation. 



Related Statements: aliasmem, cos, lu, mode 
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PARMSYN Statement 



The parmsyn statement defines new names for NetView command operands. This 
statement is coded in the dsicmd member of dsiparm. 

When help is used, only the original operand name is used in the help information. 

All parmsyn statements for a cmdmdl must follow the cmdmdl and precede the 
cmdsyn statements. 

Note: Do not use parmsyn for vtam commands. 



f£fabel] PARMSYN mgularvaiue,addWonalvaluB 



regularvalue 

is the original NetView command operand name. 

additionalvalue 

is a new 1- to 8-character operand name. NetView accepts either the old or the 
new operand name. 

Related Statements: cmdmdl, cmdsyn 
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PCLASS Statement 



The pclass statement controls the measurement parameters used by the response 
time monitor. These measurement parameters include: 

• The time boundaries between the response time counters 

• The response time definition used for a session 

• The response time objective used for a session 

• Whether you can display the response time of the last transaction for their 
session. 

If you do not code any of the statements discussed in this section, the following 
defaults are used for all sessions: 

• The boundaries between the counters are at 1, 2, 5, and 10 seconds. 

• Response time is defined as "time to first character." 

• You cannot display your own response time. 

• No response time objective is defined. 

If the defaults are acceptable, you can omit this statement, but you must not code 

the INITMOD AAUINLDM PERFMEM = membername Statement. 

Two statements control the response time monitor. The first, pclass, is used to 
define performance classes; the second, mapsess, is used to map each session into 
one of the defined performance classes. A performance class determines the 
response time measurement parameters for the sessions mapped into that per- 
formance class. 

If you code pclass and mapsess statements, create a member in dsiparm and put 
them in that member. The name of this new member must match the name coded 

on the INITMOD AAUINLDM PERFMEM = membername Statement. 

You must code one pclass definition statement for each performance class you 
define. These pclass statements must be the first statements that appear in the 
member of dsiparm named on the initmod aauinldm perfmem= membername definition 
statement. 



cname PCLASS ABOUNDS- fc.frcdli fl. 2.5.1 (ft 1 

[ ,I*TDEF - FIRSI|CDEB|KEYBD|LAST J 

r.DSPLYLOC»YESINQ1 

[ ,OBJHME~mm:ss.s|00m£J 

r.OBJPCT-pppifil 



cname 

is the name of the performance class you define. This name is used on one or 
more mapsess statements as the value of cname in the pclass parameter. The 
name starts in column one of the statement and is required. 
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BOUNDS - la.b.cM H .2.5.10) 

lists the upper time limit on each of the first four response time counters. 
These times can be specified in minutes, seconds, and tenths of seconds 
(mm:ss.s), in seconds only (ss or ss.s), in tenths of seconds only (.s), or in 
minutes only (mm:). The maximum time you can specify is 1800 seconds; any 
value of 60 seconds or more is converted to minutes for display. 

The first counter is incremented when response time is less than or equal to a; 
the second counter is incremented when response time is greater than a but 
less than or equal to b; and so on. The fifth response time counter is incre- 
mented when response time is greater than d. 

If a bounds parameter is specified with less than four boundaries coded, the 
maximum time allowed is used for the omitted boundaries. If the bounds 
parameter is omitted, the default is bounds=(i,2,5,10). 

RTDEF = FIRSTI CDEBIKEYBDILAST 

defines how response time is measured. It is measured as the time from the 
activation of a transaction, such as when the enter key is pressed, until a 
response is received. This parameter allows you to define "received" in one 
of the following ways. 

FIRST means the first character of the reply from the host has arrived at 

the user's terminal. If rtdef is omitted, first is the default. 

CDEB means an "sna Change Direction" or an "sna End Bracket" has 

been received at the user's terminal. 

KEYBD means the user's terminal keyboard is unlocked. 

LAST means the last character of the reply from the host has been 

received at the user's terminal. 

Note: If a response time monitor is monitoring an lu to lu session and the 
pclass statement defining the session uses an rtdef value not supported by the 
response time monitor, then the pclass statement is ignored and the session is 
mapped to another class. If no other classes are defined or match, the default 
performance class is used. 

DSPLYLOC = YES|NO 

controls the display of response time. 

YES allows the terminal user to display the response time of the last 

transaction at the terminal. 

NO no response is displayed. 

Note: The default is set by the rtmdisp initialization statement. If 
rtmdisp is not specified, the default for dsplyloc is no. 

OBJTIME - rom:ss.sl 00:00.0 

is the time threshold of the performance objective. It can be entered as 
minutes, seconds, and tenths of seconds (mnrss.s), in seconds only (ss or 
ss.s), in tenths of seconds only (.s), or in minutes only (mm:). The maximum 
time is 1800 seconds; any value of 60 seconds or more is converted to minutes 
for display. 

Note: If objtime is 0, no response time objective data is displayed for sessions 
mapped to this pclass statement. Refer to the mapsess statement to determine 
how sessions are mapped to a pclass statement. 

If objtime is not equal to one of the values of the bounds parameter, it is 
rounded off to the nearest bounds value. 
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Note: A response time objective includes both a time threshold and a per- 
centage. For example, for a particular terminal you might want response times 
to be less than 5 seconds (the threshold) for 80% (the percentage) of the 
activity. 

OBJPCT=ppp|0 

is the percentage portion of the performance objective. 

ppp is the percentage of transactions that should take less time than 

the time specified by objtime. 

is the default value. 

Note: If objpct is 0, no response time objective data is displayed for sessions 
mapped to this pclass statement. Refer to the mapsess statement to determine 
how sessions are mapped to a pclass statement. 

Related Statements: initmod, mapsess 
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POS Statement 



The pos statement defines the terminals that can log on directly to this NetView. 
You can code either the pos or the pospool definition statement, or code both. This 
statement is coded in the dsidmn member of dsiparm. 



[label J TOS terminalname [,..,] 



terminalname [,...] 

is the name of a terminal. 

Use the pos statement as often as necessary to define all operator terminals. 

Related Statements: pospool 
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POSPOOL Statement 



The pospool statement defines the maximum number of terminals, that were not 
previously defined with the pos statements, that can log on at one time. You can 
code either the pospool or the pos definition statement, or code both. This state- 
ment is in the dsidmn member of dsiparm. 



UabBl ] POSPOOL nfO 

n|0 



specifies the maximum number of operator terminals that can log on directly to 
this NetView and remain in session at the same time. Be careful when 
assigning this value because NetView allocates storage to accommodate each 
potential session. The default is 0. 

Note: The maximum number coded in this statement should not include any 
operator identifiers reserved for automation tasks, because automation tasks 
do not use terminals. 

Related Statements: pos 
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PROFILE Statement 



The profile statement defines the profile name to the system, profile must be the 
first statement in each profile definition. This statement is coded in a member of 
dsiprf specified by a profilen statement associated with the operator. Refer to 
"OPERATOR Statement" on page 70 and "PROFILEN Statement" on page 80 to 
determine how a profilen statement is associated with an operator. The precoded 
members used in samplib are dsiprofa and dsiprofb. 



I profilename PROFILE £HCL "hdname] 



[,IC-fexf3 



profilename 

is the name of the member that contains the profile. 

HCL — hclname 

is the name of the hard-copy printer that is automatically started when this 
operator logs on. This name must also be defined in the vtam definition and in 
the NetView hardcopy definition statement in the dsidmn member of dsiparm. 
hcl is an optional operand; if you specify both hcl and ic, hcl must precede the 
ic operand and you must separate the operands with a comma. 

Although each operator can be assigned to only one hard-copy printer, several 
operators can share the same one. However, if too many operators share the 
same hard-copy printer, messages for that device can accumulate and mes- 
sages might not be printed for some time after they are received. 

IC = text 

is the command or command list that is run immediately after the logon is suc- 
cessful. All the text on the remainder of the statement through column 71 is 
treated as the text of the command, including embedded blanks and commas. 
No enclosing quotation marks are allowed. Only commands defined on a 
cmdmdl statement as regular (r) or both (b) are allowed. 

Related Statements: hardcopy, operator, profilen 
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PROFILEN Statement 



The profilen statement associates the name of a particular profile or list of profiles 
with an operator identification. Code profilen as often as necessary to ensure that 
all the possible profile names are associated with a particular operator identifica- 
tion. An operator statement must precede each profilen statement or group of 
statements. This statement is coded in the dsiopf member of dsiparm. 



[label ] PROFILEN profilename [,...] 



profilename [,...] 

is the profile name to be associated with the operator identification defined in 
the preceding operator statement. The profile name is a 1- to 8-character 
name that matches the profilename given on a profile statement in a profile 
member of dsiprf. The first name listed in the first profilen statement is used 
by default if an operator does not specify a profile name in the logon request. 

Related Statements: operator, profile 



I 
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R (Ratio) Statement 



The r statement lets you assign initial ratio values when the first error record for a 
particular resource is received. These statements do not alter the wrap and ratio 
counts for resources already on the hardware monitor data base.. 

The r statement must follow the ctl statement, which specifies how many r and w 
statements there are. 

To change the wrap and ratio values for existing resources, use the explicit swrap 
and sratio commands (see NetView Operation). The altered values remain in 
effect until one of the following occurs: 

• The hardware alerts data base is reinitialized. 

• All hardware alert records for the particular resource and all attached 
resources are purged. 

• The values are changed by another swrap or sratio command. 

This statement is coded in the member of dsiparm specified by the mem keyword of 
the task statement whose tskid is bnjdserv. The precoded member used in samplib 

is BNJMBDST. 



rtype rname vw 



rtype 

is the resource type. This resource type must be one of the following: 

• LINE 

• CTRL 

• LCTL 

• LDEV. 

rname 

is the resource name. This name is a single name that corresponds to the 
resource type. If several resources have the same type and name, they are all 
affected, rname is required. 

vw 

is the initial error-to-traffic (e/t) ratio specified for rtype. The maximum e/t 
ratio value that can be entered is 250 (interpreted by NetView as 25.0%). The 
default e/t ratio is 3.0% for all unspecified link-attached resources and 1.0% 
for all unspecified channel-attached communication resources. 

Related Statements: ctl, task, w 
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RATE Statement 



The rate statement allows you to set the maximum rate at which events can be 
logged to the hardware monitor data base. The purpose of this function is to stop 
data base logging of repetitive events from a resource. The rate function com- 
pares the time between an event being wrapped off the data base and the new 
event record being recorded on the data base. A filter is set to block the recording 
of events from the resource if the difference is less than the time specified on the 
rate statement. 

This statement is coded in the member of dsiparm specified by the mem keyword of 
the task statement whose tskid is bnjdserv. The precoded member used in samplib 

iS BNJMBDST. 

Notes: 

1. If you do not code a rate statement, the rate value is set to zero. A value of 
zero turns off the rate function. 

2. Message bnjcmsi is issued when the filter is set. When the cause of the exces- 
sive events is determined, delete the filter entry. 

3. Message BNJ045I is issued only once every five minutes for a particular 
resource unless message bnjcmsi is issued for another resource within the five 
minutes. 

4. The recommended rate is 1 event per second for the predominate wrap count. 
This is 25 seconds using the default wrap count of 25. Low wrap counts can 
cause the filter to be set and the message to be issued erroneously. 

5. The rate function is not performed on events with a wrap count of zero or one. 



RATE mm:ss 



mm.ss 

identifies the number of minutes and seconds that must elapse, after an event 
is logged to the hardware monitor database, before another event can be 
logged. 

Related Statement: w 
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REPORTS Statement 



The reports statement specifies whether the hardware monitor report logging 
starts at NetView initialization. A report record is built for each instance that input 
problem data is stored in the hardware monitor data base. These report records 
can be written to the smf data set (mvs only) or to a data set defined by the user 
through a NetView exit, vm users must define a file and a user exit routine for 
storing report records. You can generate management reports from this file with 
the service level reporter (slr) program product (mvs only) or with a similar 
program. 

You can enable or disable record logging for report generation at initialization or at 
any time during a production run by issuing the reports command. 

Problem data blocked by the event or statistical recording filter (esrec) does not 
become part of a report record. Data from input records that result in multiple 
records written to the data base are recorded in a single report record. The 
external log record formats are in Appendix A, "External Log Record Formats" on 
page 101. 

This statement is coded in the member of dsiparm specified by the mem keyword of 
the task statement whose tskid is bnjdserv. The precoded member used in samplib 

iS BNJMBDST. 

Notes: 

1. This statement must be coded after the dstinit statement that defines bnjapama 
as the ost initialization exit. 

2. To run slr against smf logs that NetView has written in a double-byte character 
set (dbcs), you need a release of slr that supports dbcs. 



REPORTS OFFION 



OFFION 

OFF means that record logging does not start automatically at initialization. 
off is the default. 

ON means that record logging starts automatically when NetView is initial- 
ized. 

Related Statements: dstinit, task 
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RRD Statement 



The rro statement shows the domains with which an operator who has global 
control can start a cross-domain session. The rro statements can tell NetView the 
domains that contain a particular cross-domain resource. This statement is coded 
in the dsiomn member of dsiparm. 



nccfid RRD Fj?ode/7ame[,...]] 



nccfid 

is the 1- to 5-character NetView identification of the domain where this NetView 
can start a cross-domain session. The value of nccfid should match the 
NetView identifier in the other domain. This domain name is required. 

For interconnected networks, all NetViews in session with each other must 
have unique identifiers that cannot be alias names. 

nodename [,...] 

specifies the node name of a resource. If you code this node name on an rrd 
statement, you do not have to state explicitly the domain identifier when you 
route vtam commands. 

The sscp in the domain specified by nccfid must know the node name because 
NetView sends routed commands directly to that domain. These commands do 
not undergo any alias name translation by the sending sscp. 

Note: For interconnected networks, the alias name translation function allows 
the use of duplicate resource names in different networks. To avoid conflicts, 
you must define each node name only once within the set of rro statements. 
To refer to a cross-domain resource with a duplicate name, state the appro- 
priate domain name explicitly in the command. 

Related Statements: nccfid 
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SPAN Statement 



The span statement is used for span of control in vtam. span is coded in an oper- 
ator profile, it defines the spans that an operator can add to span of control by 
using the start span command. These spans are not in the operator's control at 
logon. 

span can be used as often as necessary to define all the desired span names. This 
statement is coded in a member of dsiprf specified by a profilen statement associ- 
ated with the operator. Refer to "OPERATOR Statement" on page 70 and 
"PROFILEN Statement" on page 80 to determine how a profilen statement is asso- 
ciated with an operator. 



||7abe/] SPAN Bpamamel,...} 

spanname [,...] 

specifies the 1- to 8-character name of the span. The same span name can be 
used in more than one profile. These span names are associated with vtam 
resources through the NetView spanlist statement and span operands in the 
vtam definition. 

Related Statements: operator, profilen, spanlist 

For more information concerning vtam installation, refer to "Minor Node 
Definitions" on page 63. 
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SPANLIST Statement 



The spanlist statement associates a span or list of spans with a particular vtam 
major node. If a resource is in more than one span, code all spans that include 
this resource. You can use more than one spanlist statement for the same major 
node. This statement is coded in the dsispn member of dsiparm. 



gpnglHpjl 



nod0nant0 SPANLIST [spaw)ame[,. ..JJ 



nodename 

specifies a major node name that is known to vtam. This is the name of a 
major node definition in dsivtam. 

spanname [,...] 

specifies the unique 1- to 8-character name of the span containing this major 
node. 

Related Statements: span 

For more information concerning vtam installation, refer to "Minor Node 
Definitions" on page 63. 
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STATOPT Statement 



The statopt parameter values are used to control the functions of the status 
monitor. These parameters are coded following the applicable vtam node defi- 
nition statements. This statement is coded in the member that defines a resource 

in DSIVTAM. 

The statopt parameters enable the following: 

• A specific description for the node is coded in place of the default node 
description. 

• The node is excluded from automatic reactivation by NetView. 

• The node is excluded from status monitor activity displays. 

• The node, plus ail the dependent lower nodes that follow, are omitted from 
status monitor's view of the network definition. 

There are three basic types of statopt statements within major node definition 
statement members: 

• A statement following an initial major node macro instruction statement 
(lbuild, vbuild, or pccu macro instruction) that defines a descriptive name for 
the major node when the default is not desired. 



• 



A statement following a vtam or ncp macro instruction definition statement for a 
minor node. 



STATOPT- [(['/?odeo-esc'][,NOMONIT][,NOACTY])|OMIT ] 



It is not necessary to code a statopt statement for every vtam node definition. The 
defaults for a node for which a statopt statement is not coded are given in the 
parameter descriptions below. 

STATOPT - 

is used to control major or minor node monitoring functions for the status 
monitor. 

The rules for adding the statopt statement are as follows: 

• The statements must be inserted directly after the related vtam macro 
instruction definition. They must not be inserted between statements for 
the same vtam macro instruction (between continuation statements). 

• Each statement must be coded on a single record. 

• Position 1 must contain an asterisk (*) to cause vtam to treat it as a 
comment statement. 

• statopt must start in position 16. 

• All parameters must follow directly after the equal sign (=). Do not leave 
a blank after the equal sign. 

• The vtam vbuild statement must be present in application major node defi- 
nitions or the statopt statements are not recognized by the preprocessor. 
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If nodedesc is coded with one or more of the other parameters, then it must 
be the first parameter. The other parameters can be coded in any order. 
nodedesc must be enclosed in single quote marks. 



nodedesc 



NOMONIT 



NOACTY 



is the 14-character description of any major or minor node. The 
description is displayed on the descript form of the status detail 
displays. 

The description must not include any single quotes. If no 
description is coded, the following statopt default descriptions 
for the node types are used: 



Node Group 

Application Major Node 

Application Minor Node 
cdrm Major Node 

cdrm Minor Node 
corsc Major Node 

cdrsc Minor Node 
Local Non-SNA Terminal Major Node 

Local Non-SNA Terminal Minor Node 
Local sna pu/lu Major Node 

Local sna pu Minor Node 

Local sna lu Minor Node 
ncp Major Node 

Line Minor Node 

Remote pu Minor Node 

Remote lu Minor Node 

Remote Cluster Minor Node 

Remote Terminal Minor Node 
Channel-Channel Major Node 

Line Minor Node 

pu Minor Node 
Switched Major Node 

Switched pu Minor Node 

Switched lu Minor Node 



Default Description 

APPL MAJ NODE 

APPLICATION 
CDRM MAJ NODE 

CDRM 
CDRSC MAJ NODE 

CDRSC 
LOCAL 3270 MAJ 

local dev-addr 

LCL SNA MAJOR 

LOCAL SNA PU 

LOCAL SNA LU 
NCP MAJOR NODE 

LINE 

PU 

LU 

CLUSTER 

TERMINAL 
CTC MAJ NODE 

LINE 

PU 
SWITCHED MAJOR 

SWITCHED PU 

SWITCHED LU 



Note: STATOPT =* nodedesc can be coded in atcstrxx to specify 
a host description. All other parameters coded in atcstrxx on a 
statopt statement are ignored. The default host description is 

STATMON HOST. 

excludes the node from automatic reactivation. Code the nomonit 
parameter on a statopt statement for those nodes that you do not 
want to use automatic reactivation. If this parameter is not 
present, the node is included for automatic reactivation when 
monitoring is on. Do not code this option for major nodes or 
applications. Refer to "O MONIT Statement" on page 68 to deter- 
mine how to enable monitoring. 

excludes the application node from activity recording. Code the 
noacty parameter on a statopt statement for the nodes that are 
excluded from activity displays. The default condition includes 
the node in the activity displays if the node is an application 
node. 
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OMIT excludes the node, plus all the dependent lower nodes, from the 

status monitor's view of the network definition. If this parameter 
is not coded, the node is included in the status monitor's view of 
the network. When you specify omit after a vtam definition for a 
cluster, the cluster and the terminals defined on the cluster are 
omitted from status monitor's view of the network definition. 



Using STATOPT to Define Major Nodes 




STATOPT = majnode 

STATOPT -majnode can be coded in your atcconxx vtamlst member or in your 
cnmconxx vtamlst member to define major nodes to the status monitor. 

majnode 

is a 1 to 8 character major node which must follow directly after STATOPT= 
and must be followed by a blank, majnode must not be enclosed in quote 
marks. 

majnode is the only statopt parameter that is recognized in atcconxx and 
cnmconxx members. All other parameters coded in atcconxx or cnmconxx on 
a statopt statement are ignored. 

Related Statements: o monit 
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STORPOOL Statement (MVS Only) 



The storpool statement controls the method that is used for storage allocation. It 
is coded in the dsidmn member of dsiparm. 



STORPOOL SIZE=n|0 



SIZE = n|0 

If you code a size from 1 to 7, NetView uses the mvs/xa storpool management 
services (cpool). The amount of pre-al located storage specified to cpool by 
NetView is then multiplied by the value coded in the storpool statement. 

A value of 1 is recommended, because values greater than 1 can result in 
wasted storage. Setting storpool to does not take advantage of the mvs/xa 
storpool management services (cpool) and is not recommended. 

The storpool feature is used in storage requests for NetView tasks that satisfy th' 
following criteria: 

• The tasks must be running under mvs/xa 

• The tasks must be authorized 

• Subpools must be from through 15 

• Storage sizes must be from 1 through 4064 

• The tasks must be running above the 16-megabyte storage line. 

Related Statements: None 
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T (Timer) Statement 



The t statement allows you to set timers that control how often NetView Issues 
certain vtam network status commands. The network status commands are used 
by status monitor. If you do not code this statement, NetView does not issue these 
commands. You can set the timers to one-minute intervals. This statement is 
coded in the dsicnm member of dsiparm. 



1APPLS I PENDING mm comments 



T 



is the statement name and must be in column 1. 



APPLS | PENDING 

is the name of the timer to be set. This name must begin in column 3 of the 
statement. 

APPLS specifies that you want to set the timer for NetView to automat- 

ically issue the vtam command: d net.appls. 

PENDING specifies that you want to set the timer for NetView to automat- 

ically issue the vtam command: d net.pending. 

mm 

is the number of minutes between vtam commands. This value must begin in 
column 18. 

Notes: 

1. Consider the strain that can be placed on the network before you decide 
the value for mm with either appls or pending. While setting a larger 
number of minutes means better network performance, it also means less 
accurate status information. Similarly, setting a low value decreases the 
level of performance in the network, but increases the accuracy of the 
status information. If you set mm to 0, the vtam command is not issued. 

2. For larger networks, specify values for mm, with either appls or pending, 
that are relatively prime (not multiples of each other). 

comments 

columns 20 through 80 are unused space for the statement. Code any com- 
ments you want included with the statement in columns 20 through 80. 

Related Statements: None 
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TASK Statement 



The task statement defines a task to NetView. This statement is coded in the 
dsidmn member of dsiparm. 



{label J TASK MOD-modutenam© 

JSKID » taskname 



[ ,MEM - membemame J 

[,Pm~nff] 

[,INIT-Y|N] 



MOD = modulename 

is a 1- to 8-character name of the module that runs a task. This is a required 
operand. For NetView data services, the module name is dsizdst. 

TSKID -taskname 

is a 1- to 8-character name that specifies the task. This operand is required 
and must be a unique name. 

MEM — membemame 

is the user-defined initialization member name in dsiparm that is used by this 
task. This task is responsible for the format and contents of this member. For 
IBM-supplied NetView tasks, the initialization member is processed only when 
mod= dsizdst. For more information, see "DSTINIT Statement" on page 24. 

PRI=n|9 

is a number that defines the dispatching priority of this task in relation to other 
subtasks running in this NetView. The value of n can be from 1 through 9. 
Number 1 is the highest priority you can assign, and 9 is the lowest. If no pri- 
ority value or an incorrect value is specified, 9 is the default. Primary poi task 
is priority 0, hard-copy task is priority 2, and operator station task and 
NetView-NetView task are priority 4. 

INIT»Y|N 

specifies when the task begins. 

Y specifies that NetView initialization starts the task. 

N specifies that the NetView start command must be issued to start the 
task, n is the default value. 

Related Statements: dstinit 
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TRANSTBL Statement 



The transtbl statement defines a character translation set to NetView. It is used in 
the dsidmn member of dsiparm. 



|f7ai>e/l TRANSTBL CNA 

MOD = DSIEBCPCI PSIKAN JIIPS1KTKNA 

specifies a particular load module name that contains a 1024-byte character 
translation set. Specify mod=dsiebcdc for ebcdic support, mod=dsikanji for 
Kanji support, or mod=dsiktkna for Katakana support. 

DSIEBCDC selects an 8-bit coded character set called ebcdic. This is the 
default selection. 

DSIKANJI selects a character set of symbols used in Japanese 

ideographic alphabets called Kanji. 

DSIKTKNA selects a Japanese character translation set called Katakana. 

Notes: 

1. All devices must use the same character set for meaningful results. 

2. The transtbl value for the log printer program should be the same value as 
the value used for the NetView definition. NetView does not check these 
values for compatibility. 

3. If you define more than one transtbl statement, NetView uses the last one you 
entered. 

Related Statements: None 
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VALCLASS Statement 



The valclass statement associates a command value with one or more scope 
classes. Operators having these scope classes coded in an opclass statement in 
their profiles or who have global control (no opclass statement in their profile) can 
run a NetView command using this value. 

Code the valclass statement immediately after its related keyclass statement and 
before the next keyclass or cmdmdl statement. If you want scope of commands for 
the value and not for the keyword, code keyclass without any scope class. This 
statement is coded in the dsicmd member of dsiparm. 



vafue\~ OTHER VALCLASS scopeclassl,.^ 



value] = OTHER 

value specifies a value of the command operand defined by the previous 

keyclass statement that is to be scope-checked. 

See Appendix D, "Command Keywords and Values that can be 
Scope Checked" on page 139 for a list of keywords and keyword 
values that can be scope checked. 

- OTHER lets a user check the scope for all other values that were not specif- 
ically entered for a command operand. 

Note: You can code multiple valclass statements; however, 
= other can be coded only once and only on the last valclass state- 
ment. 

scoped ass [,...] 

specifies a scope class that can use the value. The value of scoped ass must 
be a number from 1 to 2040. 

Related Statements: cmdmdl, keyclass, opclass 
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VPDINIT Statement 



The vpdinit statement defines the parameters supplied to subtask vpdtask at initial- 
ization, vpdtask is the NetView subtask that collects and logs vital product data 
(vpd). This statement is coded in the member of dsiparm specified by the mem 
keyword on the task statement where mod=dsivmatk. The precoded member used 

in SAMPLIB is DSIVPARM. 



pfPDJNIT ACBNAME=ac6name 

[,PASSWORD=passworcTJ 

LVPDWAIT=fwni3a] 
i,VPDREQ=nnn\11 
[,SNAPRQ=ON|OFQ 
[,VPDSTOR=/w|2] 



ACBNAME=acb/?ame 

specifies the 1- to 8-character acb name defined for subtask vpdtask on the 
vtam appl statement. NetView uses acbname to open its interface with vtam. 
acbname must match the acbname specified in vtamlst. 

PASSWORD -password 

specifies the 1- to 8-character password associated with acbname. If you code 
a password on the vtam appl statement in vtamlst for subtask vpdtask, you 
must code the same password here. 

VPDWAIT=nnn|30 

specifies how long NetView should wait for a response to a request for vpd 
before timing out. Depending on the relative time between when the last time 
out check was made and when the vpd request is submitted, NetView will wait 
for a response to the request between nnn seconds and two times nnn seconds 
before timing out. The value of vpdwait must be a number from 30 to 999 
seconds. The default is 30. 

VPDREQ=nrm|i 

specifies the maximum number of queued requests for vpd that vpdtask 
accepts for processing. The request for vpd can be vpdcmd own, vpdcmd all, or 
vpdcmd dce. The value of vpdreq must be a number from 1 to 999. The default 
is 1. 

SNAPRQ=ON|QFF 

specifies whether the snap trace option should be turned on at vpdtask initial- 
ization. The snap option can be turned on or off later, using the vpdcmd snap on 
(or off) command. The default is off. 

VPDSTOR=n/7|2 

specifies the number of kilobytes allocated for formatting vpd that comes back 
in response to a vpd request. The value of vpdstor must be a number from 2 to 
32. The default is 2. 

There is no standard way to determine the optimal value for vpdstor. If you 
receive message DWO019 (insufficient storage), increase the value until you no 
longer receive the message. 

Related Statements: None 
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VSAMLSR Statement 



The vsamlsr statement tells NetView whether to build a pool of global vsam buffers 
that it can use for all data services tasks. If the initialization statement, dstinit, 
specifies macrf=lsr or macrf=dfr, NetView uses this pool of buffers. This state- 
ment is coded in the dsidmn member of dsiparm. 



{label ] VSAMLSH bldvrpmodname 



■ 



bldvrpmodname 

is the name of a load module containing a compiled and link-edited bldvrp 
macro instruction (list form) that specifies global vsam buffers in NetView. 

The following example uses the name that is coded in the IBM-supplied dsizvlsr 
csect, which contains the bldvrp macro instruction: 

VSAMLSR DSIZVLSR 

Assemble and link-edit this module into the link library. The module name should 
be the same as bldvrpmodname. 

If you add a vsamlsr statement, you should also add dstinit macrf=lsr or dstinit 
macrf=dfr to one or more of the dst initialization members for dsts with 

FUNCT = VSAM or FUNCT=BOTH. 

Related Statements: dstinit 
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W (Wrap) Statement 



The w statement lets you assign initial wrap values when the first error record for a 
particular resource is received. These statements do not alter the wrap and ratio 
counts for resources existing on the hardware alerts data base." 

Initial wrap count values nnn shown on the three w statements can be specified for 
event (ev), statistical (st), or alert (al) data types. With the exception of alert data, 
wrap count statements must indicate the resource type (rtype). 

The w and R statements assign initial wrap and ratio values when the first error 
record for a particular resource is received. The w statement must follow the ctl 
statement, which specifies the number of r and w statements. 

To change the wrap and ratio values for existing resources, use the explicit swrap 
and sratio commands (see NetView Operation). The altered values remain in 
effect until one of the following occurs: 

• The hardware alerts data base is reinitialized. 

• All hardware alerts records for the particular resource and all attached 
resources are purged. 

• The values are changed by another swrap or sratio command. 

This statement is coded in the member of dsiparm specified by the mem keyword of 
the task statement whose tskid is bnjdserv. The precoded member used in samplib 

iS BNJMBDST. 



W EV[ rwn|025 ] rtype 

W ST[ /?n/7|025 ] rtype 

W AL[ nnn\W0 ] 



EV 

is the event data type. 

nnn\025 selects the initial wrap count value, from 1 to 999, for ev. The 

default value is 025. To use the default, place a comma between 
ev and rtype. 

rtype selects the 4-character resource type. Resource types are listed 

in NetView Operation but you are not restricted to only those 
listed. 

Note: For resource types lan and ring, the default wrap count is 100. 

ST 

is the statistical data type. 

nnn\025 selects the initial wrap count value, from 1 to 999, forST. The 

default value is 025. To use the default, place a comma between 
st and rtype. 

rtype selects the 4-character resource type. Resource types are listed 

in NetView Operation but you are not restricted to only those 
listed. 
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AL 

is the alert data type. 

nnnHOO selects the initial wrap count value, from 1 to 999, for al. The 

default value is 100. 

Related Statements: ctl, task 
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Appendix A. External Log Record Formats 



This appendix provides the various log record formats that the hardware monitor 
and session monitor use to write to external logs. These logs can be smf logs on 
mvs or user-written logs. 

This appendix is intended to describe the formats of the external log records, 
which are to be accessed by customer programs. It contains general-use program- 
ming interfaces, which allow the customer to write programs that use the services 
of the NetView program. 

Note: In the following tables, a type of BinCD means binary coded decimal, which 
is a numeric value coded in binary format. 



Hardware Monitor External Log Record 



Table 3. 


External 


Log Record Header Format for Hardware Monitor 




Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 








2 


BRFRLEN 


Length of record including this 
header 


BinCD 


2 


2 


2 


BRFRSEG 


Segment descriptor 


BinCD 


4 


4 


1 


BRFRFLG 


System indicator 


Hex 


5 


5 


1 


BRFRRTY 


Record type (set to decimal 37) 


BinCD 


6 


6 


4 


BRFRTME 


System time stamp (seconds accu- 
mulator) 


Binary 


10 


A 


4 


BRFRDTE 


System date stamp in 00YYDDDF 
format 


Packed 


14 


E 


4 


BRFRSID 


System id 


Char 


18 


12 


4 


BRFRWID 


Subsystem id (set to 'netv') 


Char 



22 



16 



BRFRSUBT 



Record subtype (set to decimal 3) 



BinCD 



Table 4 


(Page 1 


of 2). Hardware Monitor Header Format 




Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+0 


+0 


4 


BRFPRODI 


Displacement from start of external 
log header to section 


BinCD 


+4 


+4 


2 


BRFPROLN 


Length of product section 


BinCD 


+6 


+6 


2 


BRFPRONO 


Number of product sections (0 or 1) 


BinCD 


+8 


+8 


4 


BRFALLDI 


Displacement of alert report from 
start of smf header to section 


BinCD 


+12 


+C 


2 


BRFALLLN 


Length of alert section 


BinCD 


+14 


+E 


2 


BRFALLNO 


Number of alert sections (0 or 1) 


BinCD 


+16 


+10 


4 


BRFEVTDI 


Displacement of event report from 
start of smf header to section 


BinCD 



+20 



+14 



BRFEVTLN 



Length of event section 



Num 
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Table 4 


(Page 2 


of 2). Hardware Monitor Header Format 




Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+22 


+16 


2 


BRFEVTNO 


Number of event sections (0 or 1) 


BinCD 


+24 


+18 


4 


BRFSTAOI 


Displacement of statistical report 
from start of smf header to section 


BinCD 


+28 


+1C 


2 


BRFSTALN 


Length of statistical section 


BinCD 


+30 


+1E 


2 


BRFSTANO 


Number of statistical sections (0 or 
D 


BinCD 


+32 


+20 


4 


BRFMODDI 


Displacement of lpda-1 modem 
report from start of smf header to 
section 


BinCD 


+36 


+24 


2 


BRFMODLN 


Length of lpda-1 modem section 


BinCD 


+38 


+26 


2 


BRFMODNO 


Number of lpda-1 modem sections 
(0 or 1) 


BinCD 


+40 


+28 


4 


BRFLPDDI 


Displacement of lpda-2 report from 
start of smf header 


BinCD 


+44 


+2C 


2 


BRFLPDLN 


Length of lpda-2 section 


BinCD 


+46 


+2E 


2 


BRFLPDNO 


Number of lpda-2 sections 


BinCD 


+48 


+30 


4 


BRFLANDI 


Displacement of local area network 
report from start of smf record 


BinCD 


+52 


+34 


2 


BRFLANLN 


Length of local area network 
section 


BinCD 


+54 


+36 


2 


BRFLANNO 


Number of local area network 
sections 


BinCD 


+56 


+38 


4 


BRFGENOI 


Displacement of generic event 
report 


BinCD 


+60 


+3C 


2 


BRFGENLN 


Length of generic event section 


BinCD 



+62 



+3E 



BRFGENNO 



Number of generic event sections 
(0or1) 



BinCD 



Table 5. 


Product Report Format 






Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+0 


+0 


2 


BRFSUBTY 


Record subtype (set to 3) 


BinCD 


+2 


+2 


2 


BRFRELVL 


NetView release level (set to 3) 


BinCD 


+4 


+4 


4 


BRFPRONM 


Product name (set to 'netv') 


Char 



+8 



+8 



BRFTIMST 



Time stamp in form 

OOYYDDDFHHMMSSOS 



Packed 



Table 6 


(Page 1 


of 2). Alert Report Format 




Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+0 


+0 


8 


BRFDOMNM 


Domain name 


Char 


+8 


+8 


8 


BRFFLRNM 


Failing resource name 


Char 



+16 



+10 



BRFFLRTY 



Failing resource type 



Char 
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Table 6 


(Page 2 


of 2). Alert Report Format 




Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+20 


+14 


8 


BRFHINM(I) 


Resource level name 1 


Char 


+28 


+1C 


4 


BRFHITY(1) 


Resource level type 1 


Char 


+32 


+20 


8 


BRFHINM(2) 


Resource level name 2 


Char 


+40 


+28 


4 


BRFHITY(2) 


Resource level type 2 


Char 


+44 


+2C 


8 


BRFHINM(3) 


Resource level name 3 


Char 


+52 


+34 


4 


BRFHITY(3) 


Resource level type 3 


Char 


+56 


+38 


8 


BRFHINM(4) 


Resource level name 4 


Char 


+64 


+40 


4 


BRFHITY(4) 


Resource level type 4 


Char 


+68 


+44 


8 


BRFHINM(5) 


Resource level name 5 


Char 


+76 


+4C 


4 


BRFHITY(5) 


Resource level type 5 


Char 


+80 


+50 


1 


BRFCPL 


Complex link indicator (0 = no 
1 = yes) 


Hex 



+81 



+51 



BRFALT 



Alert indicator (0=no 1 =yes) 



Hex 



Table 7. 


Generic Event Report Format 






Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+0 


+0 


1 


BRFETYPE 


Event type 


Char 


+1 


+1 


9 


BRFPROID 


Product id 


Char 


+10 


+A 


4 


BRFALTID 


Alert id number 


Char 


+14 


+E 


40 


BRFDESC 


Event description 


Char 


+54 


+36 


40 


BRFCAUS1 


First probable cause 


Char 


+94 


+5E 


8 


BRFCDPTS 


Probable-cause code points 2 to 5 


Hex 



+102 



+66 



BRFFLAGS 



Generic flags 



Char 



Table 8 


(Page 1 


of 2). Event Report Format 




Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+0 


+0 


1 


BRFALRTT 


Event type for event records (See 
note) 


Hex 


+1 


+1 


1 


BRFGENCA 


General cause for event records 


Hex 


+2 


+2 


1 


BRFSPECA 


Specific cause for event records 


Hex 


+3 


+3 


2 


BRFBLKID 


Block id 


Hex 


+5 


+5 


1 


BRFUACD 


Action code 


Hex 


+6 


+6 


8 


BRFUAQL1 


Detail qualifier 1 


Char 


+14 


+E 


8 


BRFUAQL2 


Detail qualifier 2 


Char 


+22 


+16 


8 


BRFUAQL3 


Detail qualifier 3 


Char 


+30 


+1E 


48 


BRF48TXT 


Error description: probable cause 


Char 



+78 



+4E 



BRFDBKID 



Detail block id 



Hex 
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Table 8 (Page 2 of 2). Event Report Format 



Offset 
Dec. 



Offset Length 
Hex. Bytes 



Field 
Name 



Description 



Type 



+80 



+50 



1 



BRFDUACD 



Detail action code 



Hex 



+81 



+51 



BRFNMJTY 



nmvt type 

00 = NMVT 0000 

01 = NMVT 0001 

02 = NMVT 0025 

OF = Miscellaneous NMVT 
FF = Non-NMVT 



Hex 



Note: See NetView Operation for possible event types. 
Table 9. Statistical Report Format 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+0 


+0 


4 


BRFTRFFC 


Total traffic 


BinCD 



+4 



+4 



brftemps Total temp errors 



BinCD 



Table 10 (Page 1 of 2). LPDA-1 Modem Report Format 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


+0 


+0 


1 


BRFFAIL 


Failure indicator 

X'00' = N/A 

X ' 01 ' = modemIprobe 



Type 



X'02' 



LINE 



X'03 1 = REMOTE DEVICE 
X'04' = COMM (IF UNKNOWN) 
X'05' = MODEM INTERFACE 



Hex 



+1 



+1 1 



BRFLNKTY 



Link type (bsc = X'01\ 

SDLC = X'02') 



Hex 



+3 +3 1 brfrmsin remote modem status indicator 

(includes modem speed) 

X'00' = INVALID 
X' 01'= VALID 



+18 



+12 



BRFHTCTL 



Modem line hits local (0-63, X'FF' 
for n/a). This field is model 
dependent. 



Hex 



+2 +2 1 brflmsin |_ oca j modem status indicator 

(includes modem speed) 

X'00' = INVALID 
X' 01'= VALID 



Hex 



+4 


+4 


2 


BRFMODAD 


Modem address (typical X'C3F7' 
(C7)) 


Char 


+6 


+6 


6 


BRFMODTP 


Modem type (machine number or 

'N/AV') 


Char 


+12 


+C 


4 


BRFMODSP 


Data rate ('full' or 'half') 


Char 


+16 


+10 


2 


BRFLNQUL 


Modem line quality local (0-15) 


BinCD 



BinCD 



104 NetView Administration Reference 



Table 10 (Page 2 of 2). LPDA-1 Modem Report Format 



Offset Offset Length Field 

Dec. Hex. Bytes Name Description 



Type 



+20 



+14 



+30 +1E 2 



BRFLDBIN 



Rec db local indicator (n/a > < 
= ) 

X'0000'=n/a 

X'0001'=REC>-4 

X'0002'=REC<-48 

X'0003' = rec lvl within limits 



BRFRDBNO 



Rec db remote number (signed 
decimal) 



Hex 



+22 


+16 


2 


BRFLDBNO 


Rec db local number (signed 
decimal) 


Hex 


+24 


+18 


2 


BRFLNQUR 


Modem line quality remote (0-15) 


BinCD 


+26 


+1A 


2 


BRFHTCTR 


Modem line hits remote (0-63, 
X'FF' for n/a) 


BinCD 


+28 


+1C 


2 


BRFRDBIN 


Rec db remote indicator (n/a > < 
= ) 


Hex 



BinCD 



Table 11. LPDA-2 Report Format 



Offset Offset Length Field 
Dec. Hex. Bytes Name 



Description 



Type 



+1 



+1 



BRFLINK 



Link type: 

01-BSC 
02-SDLC 



Hex 



+0 +0 1 brffaind Failure indicator 

00 - N/A 

01 - dce or probe 

02 - line 

03 - remote device 

04 - communications (if unknown) 

05 - dce interface 



Hex 



+2 



+2 



brfsense 



Sense byte from dce 



Hex 



+3 



+40 



+3 



+28 



30 



brfladdr 



Local dce address (the right char- 
acter indicates which link segment 
this dce pair is located on, except 
when the local dce is in idle state) 



BRFRMT 



Remote dce report 



Char 



+5 


+5 


2 


BRFRADDR 


Remote dce address 


Char 


+7 


+7 


3 


RESERVED 






+10 


+A 


30 


BRFLOCAL 


Local dce report 


Char 



Char 



Table 12 (Page 1 of 2). Local and Remote Modem Reports 




Offset Offset Length Field 

Dec. Hex. Bytes Name Description 


Type 


+0 +0 4 brftype Modem type 


Char 



+4 



+4 



brfmodel Modem model - two ebcdic 
numbers 



Char 
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Table 12 


(Page 2 of 2). 


Local and Remote Modem Reports 




Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+6 


+6 


2 


BRFLQ 


Line quality: 0-15 


BinCD 


+8 


+8 


2 


BRFWLQ 


Worst line quality: 0-15 


BinCD 


+10 


+A 


2 


BRFIMP 


Impulse hit count: 0-63 


BinCD 


+12 


+C 


2 


BRFRDBM 


Receive level dbm 


BinCD 


+14 


+E 


2 


BRFMRDBM 


Minimum receive level dbm 


BinCD 


+16 


+10 


6 


BRFSPEED 


Modem speed- 'full' or 'backup' 


Char 


+22 


+16 


4 


BRFACTSP 


Actual modem speed (in bits per 
second) 


BinCD 



+26 



+2A 1 



BRFCTRL 



Modem control 

Point to point: 
1-primary 
2-secondary 

Multipoint: 
3-control 
4-tributary 



Char 



+27 



+1B 



brffeain Features installed 

Bit - coupler installed 

Bit 1 - reserved 

Bit 2 - integrated modem 

Bit 3 - fan-out installed 

Bits 4-7 - modem operating mode 

0000 - X6 14.4_9.6 

0001 - undefined 
0010-X6 14.4J4.4 
0011 - undefined 
0100-X7 19.2_9.6 
0101 - undefined 
0110- undefined 
0111 -undefined 

1000 - X5 9.6_9.6 

1001 - undefined 
1010-X5+9.6_9.6 
1011 -undefined 
1100-X4 4.8_4.8 
1101 -undefined 
1110 -undefined 
1111 -undefined 



Binary 



Binary 



+28 +1C 1 brffeaer Features in error 

Bit - coupler in error 

Bit 1 - reserved 

Bit 2 - reserved 

Bit 3 - fan-out in error 

Bit 4 - reserved 

Bit 5 - modem in idle state 

Bit 6 - nonvital data lost 

Bit 7 - base modem error 



+29 



+1D 1 



RESERVED 



RESERVED 



Char 
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Table 13. 


Local and Remote DSU/CSU Reports 






Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 




Type 


+0 


+0 


4 


BRFDTYPE 


dsu/csu type 




Char 


+4 


+4 


2 


BRFDMODL 


dsu/csu model - two ebcdic " 
numbers 




Char 


+6 


+6 


2 


BRFDLQ 


Line quality: 0-14 (15 = n/av) 




BinCD 


+8 


+8 


2 


BRFDWLQ 


Worst line quality: 0-14 (15 = 


N/AV) 


BinCD 



+10 



+26 



+A 



+2A 1 



BRFDBIPC 



Bipolar code errors: 0-63 

NOTE: number reported = 
integer ((actual number - 1) * 2400 / 
transmit speed) + 1 



BinCD 



+12 


+C 


10 


RESERVED 


RESERVED 


Char 


+22 


+16 


4 


BRFDACTS 


Actual dsu/csu speed (in bits per 
second) 


BinCD 



BRFDCTRL 



dsu/csu control 

Point to point: 
X' 01' -primary 
X ' 02 ' -secondary 

Multipoint: 
X' 03' -control 
X 1 04' -tributary 



Hex 



+27 



+1B 



brfdind indicators 

Bit - out of service code 

received 
Bit 1 - out of frame code 

received 
Bit 2 - DDS-initiated loopback 
Bit 3 - dsu/csu failure 
Bit 4 - dsu/csu in idle state 
Bit 5 - integrated dsu/csu 
Bit 6 - reserved 
Bit 7 - reserved 



Binary 



+28 



+1C 



RESERVED 



RESERVED 



Char 



Table 14. 


Local Area Network Report 






Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


+0 


+0 


6 


BRFLMADR 


Local mac address 


Char 


+6 


+6 


6 


BRFRMADR 


Remote mac address 


Char 


+12 


+C 


18 


BRFROUTI 


Routing information 


Char 


+30 


+1E 


6 


BRFUPADR 


Mac address of upstream member 


Char 



+36 



+24 



brfdnadr ^ac address of downstream 
member 



Char 
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Session Monitor External Log Record 

The session monitor writes to the external log under three conditions: 

• If the response time data function is active 

• If the network accounting and availability measurement function is active 

• When the record command is entered with the strgdata parameter. 

The response time data function writes record type 39 when the collect command 
with the log parameter is issued or at session end for an lu attached to a pu with 
the rtm feature. 

The network accounting and availability measurement function writes record type 
39 when a session is started, a session ends, or a record command with the 
sesstats parameter is issued. 

NetView writes a counter record (type 39) to the external log when a record 
command with the strgdata parameter is issued by an operator or a command list. 

Each record is made up of data sections preceded by an external log record 
header and a data descriptor block. 

External Record Type 

The session monitor writes one of the following type 39 records to the external log: 

RTM collection record 

Session end record 

Session start record 

Accounting and availability data collection record 

Combined session start-end record 

Bind failure record 

Init failure record 

Storage and event counters. 

Each record is divided into sections. The following sections are shown in more 
detail in "External Log Subvector Formats" on page 111. 

RTM Collection Record (Subtype X'0001') 

With the response time measurement function active, NetView writes an rtm col- 
lection record to the external log. This happens whenever a collect command 
with the log parameter is issued by an operator or a command list (clist). The 
four data sections of the rtm collection record are: 

• Product ID section 

• Session configuration data 

• Session route data 

• Session response time data. 

Session End Record (Subtype X'0002') 

When the session monitor network accounting and availability measurement func- 
tion is active, NetView writes a session end record to the external log when a 
session ends. The five data sections of the session end record are: 

• Product ID section 

• Session configuration data 
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• Session route data 

• Session response time data 

• Accounting and availability data. 

Note: The session response time data section is provided only rf response time 
monitoring is active. 

Session Start Record (Subtype X'0003') 

When the session monitor network accounting and availability measurement func- 
tion is active, NetView writes a session start record to the external log when a new 
session starts. The four data sections of the session start record are: 

• Product ID section 

• Session configuration data 

• Session route data 

• Accounting and availability data. 

Accounting and Availability Data Collection Record (Subtype X'0004') 

When the session monitor network accounting and availability measurement func- 
tion is active, NetView writes an accounting and availability data collection record 
to the external log. This occurs whenever a record command with the sesstats 
parameter is issued by an operator or a command list. The three data sections of 
the accounting and availability data collection record are: 

• Product ID section 

• Session configuration data 

• Accounting and availability data. 

Combined Session Start-End Record (Subtype X'0005') 

When the session monitor network accounting and availability measurement func- 
tion or the response time monitor function is active, NetView writes a combined 
session start-end record. This is written when a session ends before NetView has 
a chance to write the session start record for that session or when the response 
time monitor function is active and the network accounting and availability function 
is inactive. The five data sections of the combined session start-end record are: 

• Product ID section 

• Session configuration data 

• Session route data 

• Session response time data 

• Accounting and availability data. 

Note: The session response time data section is provided only if response time 
monitoring is active. 

Bind Failure Record (Subtype X'0006') 

When the session monitor network accounting and availability measurement func- 
tion is active, NetView writes a bind failure record to the external log whenever a 
session setup fails during the bind flow. The three data sections of the bind failure 
record are: 

• Product ID section 

• Session configuration data 

• Session route data. 
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Init Failure Record (Subtype X'0007') 

When the session monitor network accounting and availability measurement func- 
tion is active, NetView writes an init failure record to the external log whenever a 
session setup fails during the init flow. The three data sections of the init failure 
record are: 

• Product ID section 

• Session configuration data 

• Session route data. 

Storage and Event Counter Record (Subtype X'0008') 

NetView writes a counter record to the external log whenever a record command 
with the strgdata parameter is issued by an operator or command list. The five 
data sections of the counter record are: 

• Product ID section 

• Event counter data 

• Session awareness counter data 

• Resource counter data 

• Storage data. 
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External Log Subvector Formats 

NetView builds the external log records by adding combinations of the following 
data sections to the external log record header section and the data descriptor 
section: 

Product ID section 
Session route data section 
Session configuration data section 
Response time data section 
Accounting and availability data section 
Event counter data section 
Session awareness counter data section 
Resource counter data section 
Storage data section. 



The detailed format of each section follows. 



Table 15 (Page 1 of 2). External Log Record Header Format for Session Monitor 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


2 


LOQRLENG 


Record length 


Binary 


Internal 


+2 


+2 


2 


LOGRSEGD 


Segment descriptor 


Binary 


Internal 



+4 



+4 



LOGRSYSI 



System indicator 



Binary svc 83 



+10 +A 4 



Bit Meaning when set 

0-4 Reserved 

5 MVS/XA or MVS/370 

6 VS2 

7 VS1 



+5 


+5 


1 


LOGRRECT 


Record type (X' 27') 


Binary 


Internal 


+6 


+6 


4 


LOGRTIME 


Time stamp set by smf 
in hundredths of a 
second. 


EBCDIC 


svc 83 



logrdate Record was moved to 
the external log buffer 
on this date. The 
format is ooyydddf 
where f is the sign. 



ebcdic svc 83 



+14 +E 4 



LOGRSYID 



System identification 
(taken from sid param- 
eter) 



EBCDIC SMCASID 



+18 +12 4 



logrsubs Subsystem ID 'netv' 



ebcdic internal 
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Table 15 (Page 2 of 2). External Log Record Header Format for Session Monitor 



Offset 
Dec. 



Offset Length 
Hex. Bytes 



Field 
Name 



Description 



Type 



Source 



+22 



+16 



logrsubt Record subtype 



Binary Internal 



1 = rtm collection 

2 = Session end 

3 = Session start 

4 = Accounting and 

availability data 

5 = Combined session start-end 

6 = Bind failure 

7 = Init failure 

8 = Storage and 

event counters 



Table 16 (Page 1 of 2). Data Descriptor Section for Response Time and Accounting Data 
Functions 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


4 


LHDRPRDO 


Offset of product 
section (Note 1) 


Binary 


Internal 


+4 


+4 


2 


LHDRPRDL 


Length of product 
section 


Binary 


Internal 


+6 


+6 


2 


LHDRPRDN 


Number of product 
sections (Note 2) 


Binary 


Internal 


+8 


+8 


4 


LHDRSESO 


Offset of session con- 
figuration (Note 1) 
section 


Binary 


Internal 


+12 


+C 


2 


LHDRSESL 


Length of session con- 
figuration section 


Binary 


Internal 


+14 


+E 


2 


LHDRSESN 


Number of session 
configuration (Note 2) 
sections 


Binary 


Internal 


+16 


+10 


4 


LHDRRTEO 


Offset of route data 
section (Note 1) 


Binary 


Internal 


+20 


+14 


2 


LHDRRTEL 


Length of route data 
section 


Binary 


Internal 


+22 


+16 


2 


LHDRRTEN 


Number of route data 
sections (Note 2) 


Binary 


Internal 


+24 


+18 


4 


LHDRRTMO 


Offset of response 
time data section 
(Notel) 


Binary 


Internal 


+28 


+1C 


2 


LHDRRTML 


Length of response 
time data section 


Binary 


Internal 


+30 


+1E 


2 


LHDRRTMN 


Number of response 
time data sections 
(Note 2) 


Binary 


Internal 



+32 



+20 4 



LHDRACCO 



Offset of accounting 
and availability data 
section (Note 1) 



Binary Internal 



112 NetView Administration Reference 



Table 16 (Page 2 of 2). Data Descriptor Section for Response Time and Accounting Data 
Functions 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+36 


+24 


2 


LHDRACCL 


Length of accounting 
and availability data 
section 


Binary 


Internal 



+38 



+26 



LHDRACCN 



Number of accounting 
and availability data 
sections (Note 2) 



Binary Internal 



Notes: 

1. The offset of the first section of this type. All offsets are relative to the begin- 
ning of the record. 

2. The number of sections of this type in the record. 

Table 17 (Page 1 of 2). Data Descriptor Section for Storage and Event Counter Data 

Offset Offset Length Field 

Dec. Hex. Bytes Name Description Type Source 



+0 


+0 


4 


LCNTPRDO 


Offset of product 
section (Note 1) 


Binary 


Internal 


+4 


+4 


2 


LCNTPRDL 


Length of product 
section 


Binary 


Internal 


+6 


+6 


2 


LCNTPRDN 


Number of product 
sections (Note 2) 


Binary 


Internal 


+8 


+8 


4 


LCNTEVNO 


Offset of event 
counters (Note 1) 


Binary 


Internal 


+12 


+c 


2 


LCNTEVNL 


Length of event 
counter data section 


Binary 


Internal 


+14 


+E 


2 


LCNTEVNN 


Number of event 
counter data sections 
(Note 2) 


Binary 


Internal 


+16 


+10 


4 


LCNTSAWO 


Offset of saw counters 
(Note 1) 


Binary 


Internal 


+20 


+14 


2 


LCNTSAWL 


Length of saw data 
section 


Binary 


Internal 


+22 


+16 


2 


LCNTSAWN 


Number of saw 
counter data sections 
(Note 2) 


Binary 


Internal 


+24 


+18 


4 


LCNTARBO 


Offset of arb counters 
(Note 1) 


Binary 


Internal 


+28 


+1C 


2 


LCNTARBL 


Length of arb data 
section 


Binary 


Internal 


+30 


+1E 


2 


LCNTARBN 


Number of arb data 
sections (Note 2) 


Binary 


Internal 


+32 


+20 


4 


LCNTSTGO 


Offset of storage 
counters (Note 1) 


Binary 


Internal 


+36 


+24 


2 


LCNTSTGL 


Length of strg data 


Binary 


Internal 



section 
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Table 17 (Page 2 of 2). Data Descriptor Section for Storage and Event Counter Data 



Offset Offset Length Field 
Dec. Hex. Bytes Name 



Description 



Type 



Source 



+38 



+26 



lcntstgn Number of strg data 
sections (Note 2) 



Binary Internal 



Notes: 

1. The offset of the first section of this type. All offsets are relative to the begin- 
ning of the record. 

2. The number of sections of this type in the record. 
Table 18. Product Section 



Offset Offset Length Field 
Dec. Hex. Bytes Name 



Description 



Type 



Source 



+0 



+0 



LPRDSUBT 



Record subtype 



Binary Internal 



1 = rtm collection 

2 = Session end 

3 = Session start 

4 = Accounting and 

availability data 

5 = Combined 

6 = Bind failure 

7 = Init failure 

8 = Storage and 

event counters 



+2 



+2 



LPRDVERN NetView release level 

(set to 1) 



Binary Internal 



+4 



+4 



LPRDNAME 



Product name (set to 

'NETV') 



ebcdic internal 



Note: lprdsubt is the same as logrrect in the log record header section. 
Table 19 (Page 1 of 2). Session Configuration Data Section 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


2 


LSESREVL 


Revision level: 
X'0002' 


Binary 


VTAM 


+2 


+2 


8 


LSESPNAM 


Primary resource 
name 


EBCDIC 


VTAM 


+10 


+A 


8 


LSESPPUN 


pu of primary resource 


EBCDIC 


VTAM 


+18 


+12 


8 


LSESPLNK 


Primary link name 
(Notel) 


EBCDIC 


VTAM 


+26 


+1A 


8 


LSESPSAP 


Primary subarea pu 


EBCDIC 


VTAM 


+34 


+22 


8 


LSESPDOM 


Primary domain name 

(NCCFID) 


EBCDIC 


Internal 



+42 



+2A 8 



LSESSNAM 



Secondary resource 
name 



EBCDIC VTAM 
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Table 19 (Page 


2 of 2). 


Session Configuration Data Section 






Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+50 


+32 


8 


LSESSPUN 


pu of secondary 
resource 


EBCDIC 


VTAM 


+58 


+3A 


8 


LSESSLNK 


Secondary link name 
(Note 1) 


EBCDIC 


VTAM 


+66 


+42 


8 


LSESSSAP 


Secondary subarea pu 
name 


EBCDIC 


VTAM 


+74 


+4A 


8 


LSESSDOM 


Secondary domain 
name (nccfid) 


EBCDIC 


internal 


+82 


+52 


8 


LSESPCLS 


Performance class 
name 


EBCDIC 


Internal 


+90 


+5A 


8 


LSESCOST 


Class of service name 


EBCDIC 


VTAM > 
V2R1 


+98 


+62 


2 


LSESERN 


Explicit route number 
(Note 2) 


Binary 


VTAM > 
V2R1 


+100 


+64 


2 


LSESRERN 


Reverse explicit route 
number (Note 2) 


Binary 


VTAM > 
V2R1 


+102 


+66 


2 


LSESVRN 


Virtual route number 
(Note 2) 


Binary 


VTAM > 
V2R1 


+104 


+68 


2 


LSESTPF 


Transmission priority 
(Note 2) 


Binary 


VTAM > 
V2R1 


+106 


+6A 


8 


LSESPCID 


Unique session id 


Binary 


VTAM 



+114 +72 1 



LSESTYPE 



Session type 



EBCDIC 



VTAM 



1 = LU-LU 

2 = SSCP-LU 

3 = sscp-pu 

4 = sscp-sscp 



+115 +73 1 



lsesxnet Cross-network session 

(Y or N) 



EBCDIC 



VTAM > 
V2R1 



+116 +74 1 



lsescode Bind failure or unbind Binary 

reason code; see the 
following: 

• Offset 7 into bindf 

• Offset 15 into 

CDSESSF 

• Offset 1 into 

UNBIND. 

For more information, 
see Systems Network 
Architecture Formats. 



VTAM 



Notes: 

1. This field contains the link name and the channel unit address name. 

2. If no data is available from vtam, the default is X ' FF • . 
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Table 20. 


Route Data Section 








Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


2 


LRTEREVL 


Revision level: 
X'0001' 


Binary 


Internal 


+2 


+2 


2 


LRTENUME 


Total number of nodes 
in session path 


Binary 


Internal 



+4 +4 2 



lrtenumt Number of route ele- 
ments in lrteetab. 
This is the number of 
ncp V3 or later nodes 
in the session path. 



Binary Internal 



+6 



+6 



lrteetab 



Route element table 



Route test 



For each route element, there is a ten-byte entry with the following format: 
Table 21. Ten-Byte Route Element Entry 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


8 


LRTEENAM 


Route element name 


Binary 


Internal 



+8 



+8 



LRTEETGO 



Transmission group 
(out) number 



Binary Route test 



Note: lrteetab is an array of structures, lrteenam and lrteetgo are fields in the 
structure. 



Table 22 (Page 1 of 2). Response Time Data Section 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


2 


LRTMREVL 


Revision level: 
X'0001 ' 


Binary 


Internal 


+2 


+2 


8 


LRTMCOLB 


Collection period 
begin time stamp 
(Note 1) 


Binary 


Internal 


+10 


+A 


8 


LRTMCOLE 


Collection period end 
time stamp (Note 1) 


Binary 


Internal 


+18 


+12 


2 


LRTMOBJP 


Objective percentage 
(default is 0) 


Binary 


Internal 


+20 


+14 


2 


LRTMOBJB 


Objective counter 
number (default is 1) 


Binary 


Internal 


+22 


+16 


1 


LRTMDEF 


Response time defi- 
nition (default is F 
(first)) 


EBCDIC 


Internal 


+23 


+17 


1 


LRTMOBJF 


Objective met indi- 
cator (Y = yes, N = 
no) 


EBCDIC 


Internal 



+24 



+18 4 



LRTMTRAN 



Number of trans- 
actions measured 



Binary 



RTM 

feature 
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Table 22 (Page 2 of 2). Response Time Data Section 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+28 


+1C 


4 


LRTMTOTT 


Total response time 
(Note 2) 


Binary 


RTM 

feature 


+32 


+20 


16 


LRTMBNDS 


Four four-byte fields 
containing counter 
boundaries (Note 2) 


Binary 


Internal 


+48 


+30 


20 


LRTMBKTS 


Five four-byte fields 
with contents of 
counters 


Binary 


RTM 

feature 



+68 



+44 4 



LRTMOBJT 



Objective response 
time (Note 2) 



Binary Internal 



Notes: 

1. For lrtmcolb and lrtmcole, the first four bytes of the time stamp are the local 
time in stck format, and the last four are the conversion factor from gmt to 
local time. (Example: 982B5412 ffffcasb.) 

2. LRTMTOTT, lrtmbnds, and lrtmobjt are in tenths-of-seconds. 



Table 23 


(Page 


1 Of 


2). 


Accounting and Availability Data Section 






Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


2 




LACCREVL 


Revision level: 
X'0002' 


Binary 


Internal 


+2 


+2 


2 






RESERVED 






+4 


+4 


8 




LACCBEGT 


Collection period 
begin time stamp 
(Note 1) 


Binary 


Internal 


+12 


+c 


8 




laccendt 


Collection period end 
time stamp (Note 1) 


Binary 


Internal 


+20 


+14 


4 




LACCPCBC 


Number of control pius 
sent from primary to 
secondary 


Binary 


Internal 


+24 


+18 


4 




LACCPCCC 


Number of control 
characters sent from 
primary to secondary 


Binary 


Internal 


+28 


+1C 


4 




LACCSCBC 


Number of control pius 
sent from secondary 
to primary 


Binary 


Internal 


+32 


+20 


4 




LACCSCCC 


Number of control 
characters sent from 
secondary to primary 


Binary 


Internal 


+36 


+24 


4 




LACCPTBC 


Number of text pius 
sent from primary to 
secondary 


Binary 


Internal 



+40 



+28 



laccptcc Number of text charac- 
ters sent from primary 
to secondary 



Binary Internal 



Appendix A. External Log Record Formats 117 



Table 23 (Page 2 of 2). Accounting and Availability Data Section 



Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+44 


+2C 


4 


LACCSTBC 


Number of text pius 
sent from secondary 
to primary 


Binary 


Internal 



+48 



+30 



laccstcc Number of text charac- 
ters sent secondary to 
primary 



Binary Internal 



Notes: 

1. For laccbegt and laccendt, the first four bytes of the time stamp are local time 
in stck format. The last four bytes are the conversion factor from gmt to local 
time. (Example: 982B5412 ffffcasb.) 

2. The session monitor uses the indicators in the first byte of the rh to select 
control and text pius. bsc connections do not have control pius. 



Table 24. 


. Event Counters Data Section 








Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


8 


LEVNSTIM 


Start of the recording 
period 


Binary 


Internal 


+8 


+8 


8 


LEVNETIM 


End of the recording 
period 


Binary 


Internal 


+16 


+10 


8 


LEVNOMID 


Domain id (nccf id) 


Binary 


Internal 


+24 


+18 


4 


LEVNPIUB 


piu trace buffers proc- 
essed 


Binary 


Internal 


+28 


+1C 


4 


LEVNPIUS 


pius processed 


Binary 


Internal 


+32 


+20 


4 


LEVNSAWB 


saw buffers processed 


Binary 


Internal 


+36 


+24 


4 


LEVNSESS 


Session start notifica- 
tions 


Binary 


Internal 


+40 


+28 


4 


LEVNSESE 


Session end notifica- 
tions 


Binary 


Internal 



+44 +2C 4 



levnsesr Sessions recorded to 

VSAM 



Binary Internal 



Notes: 

1. For levnstim and levnetim, the first four bytes of the time stamp are local time 
in stck format. The last four bytes are the conversion factor from gmt to local 
time. (Example: 982B5412 ffffcasb.) 

2. saw (session awareness) is a VTAM/session monitor interface through which 
information about network session activity is exchanged. 

3. piu (path information unit): See Systems Network Architecture Formats. 
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Table 25. Session Awareness Counters Data Section 



Offset Offset Length Field 
Dec. Hex. Bytes Name 



Description 



Type . Source 



+0 


+0 


4 


LSAWASBC 


Number of non-filtered 
sessions 


"Binary 


nternal 


+4 


+4 


4 


LSAWASBM 


Session highwater 
mark 


Binary 


nternal 


+8 


+8 


4 


LSAWFLTC 


Sessions being filtered 


Binary 


nternal 


+12 


+C 


4 


LSAWFLTM 


Filter highwater mark 


Binary 


nternal 


+16 


+10 


4 


LSAWHSTE 


Sessions with an 
endpoint in the host 


Binary 


nternal 


+20 


+14 


4 


LSAWRTMC 


Sessions keeping rtm 
data 


Binary 


nternal 


+24 


+18 


4 


LSAWXNTC 


Sessions keeping 
cross-network data 


Binary 


nternal 


+28 


+1C 


4 


LSAWDOMC 


Sessions keeping 
domain data 


EBCDIC 


nternal 


+32 


+20 


4 


LSAWACTC 


Sessions keeping 
accounting data 


Binary 


nternal 


+36 


+24 


4 


LSAWSSCP 


Number of sscp to sscp 
sessions 


Binary 


nternal 


+40 


+28 


4 


LSAWSCPM 


sscp to sscp highwater 
mark 


Binary 


nternal 


+44 


+2C 


4 


LSAWSPPU 


Number of sscp to pu 
sessions 


Binary 


nternal 


+48 


+30 


4 


LSAWSPUM 


sscpto pu highwater 
mark 


Binary 


nternal 


+52 


+34 


4 


LSAWSPLU 


Number of sscp to lu 
sessions 


Binary 


nternal 


+56 


+38 


4 


LSAWSLUM 


sscp to lu highwater 
mark 


Binary 


nternal 


+60 


+3C 


4 


LSAWLULU 


Number of lu to lu 
sessions 


Binary 


nternal 


+64 


+40 


4 


LSAWLULM 


lu to lu highwater 
mark 


Binary 


nternal 


+68 


+44 


4 


LSAWRCDQ 


Sessions waiting to be 
recorded 


Binary 


nternal 


+72 


+48 


4 


LSAWRDQM 


Record queue 


Binary 


nternal 



Notes: 



highwater mark 



1. lsawfltc is the sum of the current sessions-filtered counts from session 
monitor and vtam. vtam Version 3 Release 2 Enhancements_allow sessions to 
be filtered at vtam; however, your saw=no filtering should be done at vtam 
rather than NetView. 

2. lsawfltm is the sum of the sessions-filtered highwater counts from session 
monitor and vtam since the last record strgdata request. 
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Table 26. 


, Resource Counter Data Section 








Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


4 


LARBCNT 


Number of resource 
control blocks 


Binary 


Internal 


+4 


+4 


4 


LARBMAX 


arb highwater mark 


Binary 


Internal 


+8 


+8 


4 


LARBSSCP 


Number of sscp 
resource control 
blocks 


Binary 


Internal 


+12 


+C 


4 


LARBSCPM 


sscp arb highwater 
mark 


Binary 


Internal 


+16 


+10 


4 


LARBPU 


Number of pu resource 
control blocks 


Binary 


Internal 


+20 


+14 


4 


LARBPUMX 


pu arb highwater mark 


Binary 


Internal 


+24 


+18 


4 


LARBLU 


Number of lu resource 
control blocks 


Binary 


Internal 


+28 


+1C 


4 


LARBLUMX 


lu arb highwater mark 


Binary 


Internal 


+32 


+20 


4 


LARBLNK 


Number of Mnk/CUA 

ARBS 


Binary 


Internal 



+36 



+24 4 



LARBLNKM 



Link/cuA highwater 
mark 



Binary Internal 



Note: The session monitor creates active resource control blocks (arbs) for all 
resources involved in sessions known to the session monitor. 



Table 27. 


Storagi 


3 Counter Data Section 








Offset 
Dec. 


Offset 
Hex. 


Length 
Bytes 


Field 
Name 


Description 


Type 


Source 


+0 


+0 


4 


LSTGRTM 


Storage used for rtm 
data 


Binary 


internal 


+4 


+4 


4 


LSTGPARM 


Storage used for parm 
data 


Binary 


Internal 


+8 


+8 


4 


LSTGTRCE 


Storage used for trace 
data 


Binary 


Internal 


+12 


+C 


4 


LSTGASB 


Storage used for asb 
data 


Binary 


Internal 


+16 


+10 


4 


LSTGARB 


Storage used for arb 
data 


Binary 


Internal 



+20 +14 4 



LSTGACCT 



Storage used for acct 
data 



Binary Internal 



Notes: 

1. The rtm counter represents the number of bytes of storage used for response 
time monitor data. 

2. The parm counter represents the number of bytes of storage used for session 
parameter data. 

3. The trace counter represents the number of bytes of storage used for session 
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trace data. This includes piu trace, boundary function trace, and gateway 
trace. 

4. The asb counter represents the number of bytes of storage used for active 
session block control blocks. 

5. The arb counter represents the number of bytes of storage used for active 
resource block control blocks. ' 

6. The acct counter represents the number of bytes of storage used for 
accounting data. 
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Appendix B. Network Asset Management Vital Product Data 
Descriptions and Sample Record Formats 

This appendix provides information about: 

• Vital product data (vpd) returned from the vpdcmd command 

• The record formats used by the sample network asset management command 
lists. 

Use the information provided in this appendix as a reference when interpreting 
messages returned from the vpdcmd command, when modifying the sample 
network asset management command lists or when writing your own network asset 
management command lists. 

This appendix is intended to aid the customer in writing command lists to manage 
vital product data. It contains general-use programming interfaces, which allow 
the customer to write programs that use the services of the NetView program. 

Vital Product Data Descriptions 

Messages that are returned in response to the vpdcmd command contain the fol- 
lowing types of vpd: 

• Answering node configuration data 

• Product data 

• DCE data 

• Link configuration data 

• Sense data 

• Attached device configuration data. 

Different devices support different fields of the subvectors that return the vpd. A 
message is built using all the fields supported by an answering device. The 
message reflects all the vpd that is supplied by the device (including any supported 
fields that the device returns with values of blanks or zeros.) Some devices may 
return values of blanks or zeros for fields that have no meaning to the device. 
More information on some of the fields may be available from the applicable hard- 
ware and software publications. 

Answering Node Configuration Data 

Answering node configuration data describes the node that answered the vpd 
request. Answering node configuration data is returned in the following messages: 

• DWO100I 

• DWO103I. 

Messages dwoiooi and DWO1031 contain the same fields. Message DWO1031 is issued 
instead of message dwoiooi if the configuration reported by vtam includes more 
names than the routine can manage. This happens when the amount of storage 
allocated during initialization (on the vpdstor operand of the vpdinit statement) is 
not sufficient. Because of the storage restriction, message DWO1031 does not 
contain information about the complete configuration— the higher level node iden- 
tification is not included. 
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Messages owoiooi and DWO1031 are two-part messages. One part of the message 
contains information about the node where the vpd request originated. The other 
part of the message shows the configuration of the originating node. 

The format of messages owoiooi and OWO1031 is: 



%£MW$$%z!SW$>$P- 



REQID reqid : ORIG nodetype nodename CNFG nodetype nodename [...] 




The reqid is the id that correlates this reply to a specific request. 

The nodetype and nodename following orig describe the node where the vpd 
request originated. The nodetype can be one of the following: 

PU means the physical unit name 
LSN means the link station name 
LU means the logical unit name 
LINK means the link name 
CH/LINK means the channel-link name. 



The nodename is the name of the originating node. 

The pair or pairs of nodetypes and nodenames following cnfg describe the config- 
uration of the originating node. The nodetypes can be one of the following: 

• PU means the physical unit name 

• LSN means the link station name 

• LU means the logical unit name 

• LINK means the link name 

• CH/LINK means the channel-link name. 

The nodenames are the names that make up the configuration of the originating 
node. 

Product Data (Subvectors X'10' and X*11 ') 

Message DWO1021 contains data about the type of product of a particular node. The 
data is returned in subvectors X ' 10 ' and X ' 1 1 ' . 

The format of message DWO1021 is: 



REQID reqid : prodid vpdfield=xxx [...] 



The reqid is the id that correlates this reply to a specific request. 
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The prod id identifies the type of product. The prodid can have one of the following 
values: 

IBM-HW means ibm hardware 

MIX-HW means ibm or non-IBM hardware (not distinguished) 

OEM-HW means non-IBM hardware 

IBM-SW means ibm software 

MIX-SW means ibm or non-IBM software (not distinguished) 

OEM-SW means non-IBM software. 

The vpdfield=xxx represents a combination of various fields and values that 
describe the type of product of a particular node. The message reflects all the data 
returned from the device. Depending on the device, different fields are used to 
build this portion of the message. All the fields returned from the device are used 
(even if they contain blanks or zeros). 

The fields that can be contained in DWO1021 are: 

Field Value 

M/T The machine type of the hardware product 

MDL The machine model number of the hardware product 

MFG The plant of manufacture of the hardware product 

S/N The sequence number of the hardware product 

EM/T The machine type of the emulated product 

EMDL The machine number of the emulated product 

COMPID The software serviceable component identifier 

REL The software serviceable component release level 

VER The software product common version identifier 

RLS The software product common release identifier 

MOD The software product common modification identifier 

SPROD The software common product name 

NODEID The software product customization identifier 

PPN The software program product number 

CSD The software product customization date in yy/ddd format 

CST The software product customization time in hh:mm format 

ECL The microcode EC level 

HPROD The hardware product common name 

VID The vendor identification. 
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DCE Data for Modems (Subvector X ' 50 * ) 

Message DWO1121 contains dce data for modems retrieved from a dce that supports 
read-configuration lpda-2 commands. The data is returned in subvector X' 50 ' . 

The format of message DWO1121 is: 



REQIO reqid : vpdfield-xxx [...] 



The reqid is the 10 that correlates this reply to a specific request. 

The vpdfield=xxx represents a combination of various fields and values that 
contain lpda-2 dce link connection subsystem data. The message reflects all the 
data returned from the device. Depending on the device, different fields are used 
to build this portion of the message. All the fields returned from the device are 
used (even if they contain blanks or zeros). More information on some of the fields 
may be available in your modem publications. 

The fields that can be contained in DW01121 are: 

Field Value 

CLSL The current link segment level 

ADDR The dce address 

DCESNS The 2-character lpda2 sense code 

M/T The modem type 

MDL The modem model 

PORT The dce port identifier to which the dte is connected (fan in/fan out 
modems only) 

FEAT The modem features. The value of feat will be one of the following: 

CPL means a coupler is installed 

DMPX means a data multiplexer is installed 

FAN means a fan-out is installed 

DTE means dte is connected 

DIR means direction connection 

TAI means tailed cable connection. 

CECL The card ec level 

PECL The packaging ec level 

HROS The high speed ros ec level 

LROS The low speed ros ec level 

S/N The serial number 

SPD The speed in use: full or backup 

NSP The normal (full) speed 

BSP The backup speed 
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FNC The network function. The value of fnc will be one of the following: 

• PRI means the modem is primary in point to point 

• SEC means the modem is secondary in point to point 

• CTL means the modem is control in multipoint - 

• TRI means the modem is tributary in multipoint. . 

CLK The clock options. The value of clk will be one of the following: 

• INT means the modem uses an internal clock 

• EXT means the modem uses a DTE-provided clock 

• RCV means the transmit clock is locked to the receive clock. 

DCE Data for DSUs/CSUs (Subvector X'50 1 ) 

Message DWO1131 contains dsu/csu data retrieved from a local dce that supports 
modem-and-line status lpda-2 commands. Message DW01141 contains osu/csu data 
retrieved from a remote dce that supports modem-and-line status commands. The 
data is returned in subvector X' 50'. 

The format of messages Dwomi and dwoihi is: 
f REQID reqid : vpdfield=xxx [...] 

The reqid is the id that correlates this reply to a specific request. 

The vpdfield=xxx represents a combination of various fields and values that 
describe the node that could not satisfy a vpd request. The message reflects all the 
data returned from the device. Depending on the device, different fields are used 
to build this portion of the message. All the fields returned from the device are 
used (even if they contain blanks or zeros). More information on some of the fields 
may be available in your dsu/csu publications. 

The fields that can be contained in DW01131 and dwoihi are: 

Field Value 

ADDR The dce address 

DCESNS The 2-character LPDA2 sense code 

M/T The dsu/csu type 

MDL The dsu/csu model 

FEAT The modem features. The value of feat will be one of the following: 

• DTE means dte is connected 

• DDS means dds is connected 

• DIR means direction connection 

• TAI means tailed cable connection. 

CECL The card ec level 

MECL The micro code ec level 
S/N The serial number 
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FNC The network function. The value of fnc will be one of the following: 

• PRI means the modem is primary in point to point 

• SEC means the modem is secondary in point to point 

• CTL means the modem is control in multipoint 

• TRI means the modem is tributary in multipoint. 

XSP The transmission speed. 

Link Configuration Data (Subvector X'52') 

Message owonoi contains data about the configuration of a link connection. The 
data is returned in subvector X'52'. 

The format of message dwohoi is: 
REQID reqid : vpdftefd=xxx [...] 



The reqid is the id that correlates this reply to a specific request. 

The vpdfield=xxx represents a combination of various fields and values that 
describe the link connection. The message reflects all the data returned from the 
device. Depending on the device, different fields are used to build this portion of 
the message. All the fields returned from the device are used (even if they contain 
blanks or zeros). More information on some of the fields may be available in your 
nop publications. 

The fields that can be contained in owonoi are: 

Field Value 

PRT The port address (see NCP and EP Reference Summary and Data 

Areas) 

RDLCADR The remote device sdlc address 

MDT The modem features. The value of mdt will be one of the following: 

• STD means that the modem does not have a multiplex link 
feature 

• DMPX means that the modem has a multiplex link feature 

• EXT means that the local dce is external to the sending node 

• ITQ means that the local dce is integrated to the sending node. 

LSLN The number of link segments active on this link connection for a 

given link station 

LDA The local device address 

MCN The modem correlation number 
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STA The lcs link station attributes, sta can be further qualified with one 

value from each of the following groups: 

• Link station role 

- PRI means the node is the primary link station 

- SEC means the node is the secondary link station 

- NEG means the node can negotiate the role of the link 
station. 

• Remote link station node type 

- T01 means the remote link station node type is 01 

- T02 means the remote link station node type is 02 

- T04 means the remote link station node type is 04 

- T21 means the remote link station node type is 2.1 

- NSN means the remote link station node type is non-SNA. 

LKA The link attributes, lka can be further qualified with one value from 

each of the following groups: 

• Connection type 

- LSD means the connection is leased 

- SWC means the connection is switched. 

• Connection mode 

- HDX means the connection mode is half-duplex 

- FDX means the connection mode is full-duplex. 

• Connection protocol 

- SDLC means the connection protocol is sdlc 

- BSC means the connection protocol is bsc 

- S/S means the connection protocol is Start/Stop. 

PTP The connection configuration is point-to-point 

MTP The connection configuration is multipoint 

FPD The lpda fault lsl descriptor. 

Sense Data (Subvector X'7D') 

Message dwohh contains sna sense data supplied by a node that could not satisfy 
a vpd request. The data is returned in subvector X'7D '. 

The format of message dwohh is: 
iHEQID mqfd : SNS sens&code 



The reqid is the id that correlates this reply to a specific request. 

The sensecode following sns is the 8-character hexadecimal sense code of the 
node that could not satisfy a vpd request. 
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Attached Device Configuration Data (Subvector X ' 82 ' ) 

Message DWO1011 contains data about the configuration of a device attached to the 
node that reports the vpd. The data is returned in subvector X' 82'. 

The format of message dwoioii is: 
REQID reqid : vpdftel<t~xxx -[...J 1 

KcsSsSisSsSil'liiillH 

The reqid is the id that correlates this reply to a specific request. 

The vpdfield=xxx represents a combination of various fields and values that 
describe the attached device. The message reflects all the data returned from the 
device. Depending on the device, different fields are used to build this portion of 
the message. All the fields returned from the device are used (even if they contain 
blanks or zeros). 

The fields that can be contained in dwoioii are: 

Field Value 

PORT The port number where this device is attached 

PWROS The power-on status of this device 

PWROL Specifies whether this device has been powered-on since the last time 
a solicitation for vpd was issued. 
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Format of Records Created by Network Asset Management Sample 
Command Lists 

The sample network asset management command lists are: 

Command List Function 

VPDLOGC Generates and logs start and end records when called by the 

vpdall command 

VPDPU Collects and logs vpd from a specified pu (and optionally its ports) 

in your domain 

VPDDCE Collects and logs vpd from all of the does existing in a direct path 

between a specified ncp and pu in your domain 

VPDXDOM In conjunction with the vpdlogc, vpdpu, and vpddce command lists 

and a message automation definition, the vpdxdom command list 
allows a focal point to collect vpd from devices attached to 
another NetView program, vpdxdom sets the record type number 
of the NetView soliciting for vpd to that of the focal point NetView. 
This ensures that all of the collected vpd is logged with the same 
record type number under the focal point NetView. 

You can use the sample command lists as they are shipped to perform basic vpd 
collection. If the sample command lists do not suit your particular network asset 
management requirements, you can modify the existing command lists, or you can 
write your own. 

The sample command lists assign a record type number of 37 to each log record 
created. Record type number 37 is the record type number for hardware monitor 
records. The record type number is used to log the vpd into an external file. The 
record type number is set as a common global variable named smfvpd during exe- 
cution of NetView's initial command list, cnmeiom. If command list cnmeiom is not 
run, global variable smfvpd is not set. If smfvpd is not set, the sample command 
list will set it to its default (37) and continue processing. 

If you plan to write your own command lists to collect and log vpd, you must do the 
following: 

• Define the format of each type of log record you want to create. 

• Assign a record type number between 128 and 255 to each type of log record 
created. 

• Install an external logging facility if you want to log vpd into an external file. 
After logging data into an external file, you can manipulate the data using tools 
such as slr or Info/Management. 
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The records written by the sample command lists through the NetView external 
logging facility consist of a common prefix that contains the smf header followed by 
variable data. The variable data is contained in one of the following subrecords: 

Start (subtype s) 

End (subtype E) 

PU hardware (subtype p) 

PU software (subtype f) 

dce hardware (subtype m) 

Timeout (subtype t) 

Error (subtype w). 

Each subrecord contains a collect identifier field. This field correlates the records 
written during the same data collection. The last two digits of the collect identifier 
indicate the method used to collect the data. 

The following sections describe the format of the common prefix and the different 
subrecords. 



Format off Subrecord Prefix 

Each record created by the sample command lists is preceded by a common 
record prefix, or header, which contains identifying information about the record. 

Table 28. Format of Common Record Prefix 



Record 
Offset 


Offset In 
CMD Proc 


Length 
Bytes 


Description 


0000 




2 


Record length 


0002 




2 


Reserved 


0004 




1 


Reserved 


0005 




1 


Record number 


0006 




4 


time (sec/100) 


0010 





4 


date (OOyydddf) 


0014 




4 


System id 


0018 


— — . 


4 


Subsystem id (set to vpd) 



0022 



Subsytem record number (set to 22) 



Format of Start Subrecords 

Start subrecords (subtype s) contain information about the start of data collection. 
Start subrecords are written by vpdlogc, which is called by the vpdall command at 
the start of data collection. 



Table 29 (Page 1 of 2). Format of Start Subrecords 



Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 


0024 


0001 


1 


Record subtype (s) 


0025 


0002 


8 


NetView domain id 



0033 



0010 



12 



Collect identifier 
(mmddyyhhmm99) 
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Table 29 


(Page 2 of 2). 


Format of Start Subrecords 




Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 




0045 


0022 


8 


Operator id 


- 


0053 


0030 


8 


Req (set to vpdall) 


- 



0061 



0038 



Trailer (set to vpd) 



Format of End Subrecords 

End subrecords (subtype e) contain information about the end of data collection. 
End subrecords are written by vpdlogc, which is called by the vpdall command at 
the end of data collection. 



Table 30. 


Format of End Subrecords 




Record 
Offset 


Offset In 
CMD Proc 


Length 
Bytes 


Description 


0024 


0001 


1 


Record subtype (e) 


0025 


0002 


8 


NetView domain id 


0033 


0010 


12 


Collect identifier 
(mmddyyhhmm99) 


0045 


0022 


8 


Operator id 


0053 


0030 


12 


End of collect 
(mmddyyhhmmss) 


0065 


0042 


8 


Record counter (see note 1) 


0073 


0050 


8 


Number of calls to vpdpu (see note 2) 


0081 


0058 


8 


Reserved 


0089 


0066 


8 


Number of calls to vpddce (see note 2) 


0097 


0074 


8 


Reserved 



0105 



0082 



Trailer (set to vpd) 



Notes: 

1. This field contains the total number of records, generated since the start sub- 
record, that can be written to an external logging facility. This field does not 
represent the number of records that were successfully written to the external 
logging facility. 

2. This field contains the total number of calls made to the vpdpu or vpddce 
command list. It does not represent the number of successful completions of 
the command list. 
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Format of PU Hardware Subrecords 

pu hardware subrecords (subtype p) contain information about the hardware char- 
acteristics of a pu. pu hardware subrecords are written by the vpdpu command list. 



Table 31. 


Format of PU Hardware Subrecords 


Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 


0024 


0001 


1 


Record subtype (p) 


0025 


0002 


8 


NetView domain id 


0033 


0010 


12 


Collect identifier 
(mmddyyhhmm99) 


0045 


0022 


5 


Machine type 


0050 


0027 


3 


Machine model 


0053 


0030 


3 


Manufacturer id 


0056 


0033 


7 


Sequence number 


0063 


0040 


10 


ec level 


0073 


0050 


8 


lu name 


0081 


0058 


8 


pu name 


0089 


0066 


8 


Link name 


0097 


0074 


8 


pu type 4 or 5 name 


0105 


0082 


6 


Attached port number 


0111 


0088 


1 


Current power on status 


0112 


0089 


1 


Power on status since last solicitation 


0113 


0090 


12 


Reserved 


0125 


0102 


8 


Reserved 


0133 


0110 


3 


Trailer (set to vpd) 



0136 0113 1to50 Reserved 

Format of PU Software Subrecords 

pu software subrecords (subtype f) contain information about the software charac- 
teristics of a pu. pu software subrecords are written by the vpdpu command list. 

Table 32 (Page 1 of 2). Format of PU Software Subrecords 



Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 


0024 


0001 


1 


Record subtype (f) 


0025 


0002 


8 


NetView domain id 


0033 


0010 


12 


Collect identifier 
(mmddyyhhmm99) 


0045 


0022 


9 


Component id 


0054 


0031 


3 


Release level 


0057 


0034 


6 


Customization date 


0063 


0040 


5 


Customization time 



0068 0045 5 Reserved 
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Table 32 


(Page 2 of 2). 


Format of PU Software Subrecords 




Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 




0073 


0050 


8 


lu name 


- 


0081 


0058 


8 


pu name 


- 


0089 


0066 


8 


Link name 




0097 


0074 


8 


pu type 4 or 5 name 





0105 



0082 



Trailer (set to vpd) 



Format of DCE Hardware Subrecords 

dce hardware subrecords (subtype m) contain information about the hardware char- 
acteristics of a dce. dce hardware subrecords are written by the vpddce command 
list. 



Table 33. 


Format of DCE Hardware Subrecords 


Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 


0024 


0001 


1 


Record subtype (m) 


0025 


0002 


8 


NetView domain id 


0033 


0010 


12 


Collect identifier 
(mmddyyhhmm99) 


0045 


0022 


5 


Machine type 


0050 


0027 


3 


Machine model 


0053 


0030 


7 


Serial number 


0060 


0037 


1 


Card ec level 


0061 


0038 


1 


Packaging ec level | micro code ec level 


0062 


0039 


11 


Reserved 


0073 


0050 


8 


Reserved 


0081 


0058 


8 


pu name 


0089 


0066 


8 


Link name 


0097 


0074 


8 


pu type 4 or 5 name 


0105 


0082 


1 


Total link segment level 


0106 


0083 


1 


Current link segment level 


0107 


0084 


2 


dce address 


0109 


0086 


1 


dce position (see note 1) 


0110 


0087 


3 


Trailer (set to vpd) 


0113 


0090 


20 


Link station attribute (see note 2) 



0133 



0110 



Varied 



dce features (see note 2) 
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Notes: 

1. This field contains a character that identifies the sequence in which the dces 
are connected. A 1 in this field indicates the dce is closest to the ncp. An n in 
this field indicates the dce is furthest from the ncp. 

2. These fields can be defined by the user. 

Format of Timeout Subrecords 

Timeout subrecords (subtype t) contain information about a vpd request that timed 
out before it was completed. Timeout subrecords are written by the vpdpu or 
vpddce command lists when the error option is specified. 



Table 34. Format of Timeout Subrecords 



Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 


0024 


0001 


1 


Record subtype (t) 


0025 


0002 


8 


NetView domain id 


0033 


0010 


12 


Collect identifier 
(mmddyyhhmm99) 


0045 


0022 


8 


Operator id 


0053 


0030 


8 


Request specified 


0061 


0038 


8 


Node name 1 


0069 


0046 


8 


Node name 2 



0077 



0054 



Trailer (set to vpd) 



Format of Error Subrecords 

Error subrecords (subtype w) contain information about a vpd request that failed. 
Error subrecords are written by the vpdpu or vpddce command lists when the error 
option is specified. 



Table 35. 


Format of Error Subrecords 




Record 
Offset 


Offset in 
CMD Proc 


Length 
Bytes 


Description 


0024 


0001 


1 


Record subtype (w) 


0025 


0002 


8 


NetView domain id 


0033 


0010 


12 


Collect identifier 
(mmddyyhhmm99) 


0045 


0022 


8 


Operator id 


0053 


0030 


8 


Request specified 


0061 


0038 


8 


Node name 1 


0069 


0046 


8 


Node name 2 


0077 


0054 


8 


Error message number 



0085 



0062 



Trailer (set to vpd) 
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Appendix C. Modem Configuration Change Form 



This appendix contains a one-page form that system programmers can use to give 
modem configuration information to operators. The fields on theiorm correspond 
to fields on the mdmcnfg panels. After the operators receive the completed form, 
they can enter the information using the mdmcnfg command. 

The form instructs the operator not to change any fields that are not filled in on the 
form. 
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Modem Configuration Change Form 

Operators- Do not change entries that have been left blank on this form. 



Modem Address: 

ID 

Station 
Modem 
Level 

Modem Configuration Changes: 

Speed Control Mode 

Training Sequence 

Configuration 

Network Function 

Antistreaming 

Transmit Clock Option 

Complementary RFS Delay 

Default Speed 

Local Loop Back Wrap 

Customer Information 

Receive Level Threshold 

Impulse Hits Threshold 

Line Quality Threshold 

Auto-Answer 

Dialing 

First Phone Number 

Second Phone Number 



ms 



(Using Node Network Name) 
(Station Network Name) 
(Local, Remote) 
(1-2) 

(M = Modem, D= DTE) 

(L = Long, S= Short) 

(M = Multipoint, P=Point-to-Point) 

(C= Control/Primary, S= Secondary) 

(Y=Yes, N = No) 

(I = Internal, E = External, R-Receive) 

(0 to 250 in 10ms increments) 

(F = Full, B = Backup) 

(Y=Yes,N = No) 

(10-Character Limit) 

(-43 to 0) 

(0to63) 

(0to14) 

(Y = Yes, N = No) 

(T = Tone, P = Pulse) 

(Valid Digits: 0-9, P = Pulse) 
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Appendix D. Command Keywords and Values that can be 
Scope Checked 

This appendix contains a table for each component of the NetView program. The 
tables list the commands that have keywords that can be scope checked and any 
scope checked values associated with that keyword. 

Notes: 

1. You can scope check all commands and command lists coded in dsicmd. This 
appendix lists only the commands having keywords that can be scope checked. 

2. You cannot scope check command list parameters. 



Command Facility 

Command Keyword Value 



AFTER 


PPT 
SAVE 




AINQ 


ORIGNAME 
TARGNAME 
TYPE 


name 
name 
LU | COS | MODE 


AT 


PPT 
SAVE 




AUPD 


ORIGNET 


name 


AUTOMSG 


MEMBER 

OFF 

STATUS 


membername 


AUTOTASK 


OPID 

CONSOLE 

DROP 


operid 
nn 


BGNSESS 


APPLID 
SRCLU 


applid 
srclu 


CANCMD 


TAG 

ID 

SP 


tag 

name 

spname 


CCPDR 


name 




CCPLOADF 


name 




CCPLOADI 


name 




CCPLOADT 


name 





DEFAULTS HOLD ENABLE | DISABLE 

BEEP ENABLE | DISABLE 

SYSLOG YES | NO 

NETLOG YES | NO 

HCYLOG YES | NO 

DISPLAY YES | NO 

CMD HI I LOW 
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Command 



Keyword 



Value 



DISPCMD 



ALL 
ID 
OP 
SP 



name 

operid 

spname 



DISPCNFG 



ID 

ALL 

PRODUCT 

LINE 

ADAPTER 

STATION 

DISPLAY 

VERIFY 

DUMP 



name 
name 
name 
name 
name 



EVERY 



PPT 
SAVE 



EXCMD 



opid 
cmd 



LINESTAT 



ID 

PORT 

LINE 

HALF 

FULL 

SNBU 

NOSNBU 

SSL 



name 

portnumber 

name 



LINKDATA 



SP 

APPL 

LINE 

RESOURCE 

UN 

ENTRYLCC 

RD 

EXITLCC 



service-point-name 

application-name 

line-name 

resource-name 

using-node 

entry-LCC 

remote-device 

exit-LCC 



LINKPD 



SP 

APPL 

LINE 

RESOURCE 

UN 

ENTRYLCC 

RD 

EXITLCC 



service-point-name 

application-name 

line-name 

resource-name 

using-node 

entry-LCC 

remote-device 

exit-LCC 



LINKTEST 



SP 

APPL 

LINE 

RESOURCE 

UN 

ENTRYLCC 

RD 

EXITLCC 

SELFCNT 



service-point-name 

application-name 

line-name 

resource-name 

using-node 

entry-LCC 

remote-device 

exit-LCC 

number-of-repetitions 



LIST 



DST 
OP 



dstname 

ALL | operid | PPT | " 
STATUS = CNMSESS 
STATUS = AMLUSESS 
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Command 



Keyword 



Value 



LPDA 


ID 


name 




STATION 


name 




LINE 


name 




QUERY 


_ 




TYPE1 






TYPE2 






TYPE3 






NONE 






ALLOW 






BLOCK 




MDMCNFG 


ID 


node 




STATION 


devicename 




LEVEL 


1|2 




MODEM 


LOCAL | REMOTE 




BROWSE 


NOCHANGE | CONFIG | COUPLER 




CHANGE 


CONFIG | COUPLER 


MDMCNTL 


ID 


usingnode 




STATION 


devicename 




LEVEL 


1|2 




MODEM 


LOCAL | REMOTE | ALLRMT 




SPEED 


FULL | BACKUP 




CONTACT 


CLOSE | OPEN | QUERY 




CONNECT 


phone#1 | (phone#1,phone#2,...) 




DISCONN 




MVS 


command verb 
first verb function 




OVERRIDE 


HOLD 


ENABLE|DISABLE|DEFAULT 




BEEP 


ENABLE|DISABLE|DEFAULT 




SYSLOG 


YES | NO | DEFAULT 




NETLOG 


YES | NO | DEFAULT 




HCYLOG 


YES | NO | DEFAULT 




DISPLAY 


YES | NO | DEFAULT 




CMD 


HI | LOW | DEFAULT 


PURGE 


TIMER 


ALL | name 




DST 


dstname 




OP 


opid | PPT | " 




REQ 


requestnumber | ALL 


RESTORE 


DELETE 
TIMER 




RUNCMD 


SP 


service-point-name 




APPL 


application-name 




CLISTVAR 


YES|NO 


RUNDIAG 


ID 


name 




PORT 


portnumber 




LINE 


name 




TEST 


testid 


START 


TASK 


taskname | DSILOG | DSIPRT | 
DSITRACE 


STOP 


FORCE 


taskname | hclname | nntname | 




TASK 


terminalname | DSILOG | DSITRACE 
taskname 



SWITCH 



taskname 

DSILOG 

DSITRACE 
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Command Keyword Value 

THRESH ID name 

STATION name 

QUERY thrvalue 

PT thrvalue 

TDT thrvalue 

TET thrvalue 

RDT thrvalue 
RET 

TRANSMSG MEMBER member-name 



Note: Most defaults are not scope checked. If a command has a default for a 
keyword such as: 

DISPCMD ALL 

where ALL is the default if only the command dispcmd is entered, then ALL is only 
scope checked when explicitly stated and not scope checked when it is the default. 



Hardware Monitor 



To scope check a hardware monitor command, treat the command as a keyword to 
the npda command. The following table shows the hardware monitor commands 
that can be scope checked as keywords to npda. 

Command Keyword Value 

NPDA PURGE/PRG 

PRGATT 
REPORTS 
SRATIO/SR 
SRFILTER/SRF 
SWRAP/SW 
DEL (see note 3) 

Notes: 

1. For the hardware monitor, cmd==> is the same as the npda command. There- 
fore, both npda and cmd==> must be scope checked in order for scope 
checking to fully function from all components. 

2. When scope checking a keyword that can be abbreviated, both the keyword 
and its abbreviation must be scope checked. 

3. del is a panel option that may be scope checked as a keyword. 



Session Monitor 



To scope check a session monitor command, treat the command as a keyword to 
the nldm command. The following table shows the session monitor commands that 
can be scope checked as keywords to nldm. 
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Command 

NLDM 



Keyword 

COLLECT 

DISABLE 

DISKEEP 

ENABLE 

FORCE 

KEEP 

LINEMAP 

LIST 

PURGE 

RECORD 

RELOAD 

RTREND 

RTSUM 

SENSE 

SESS 

TRACE 



Value 



Status Monitor 



Command 



Keyword 



Value 



MONIT 



START 
STOP 
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Glossary 



This glossary defines important NCP, NetView, 
NetView/PC, SSP, and VTAM abbreviations and terms. 
It includes information from the IBM Dictionary of Com- 
puting, SC20-1699. Definitions from the American 
National Dictionary for Information Processing are 
identified by an asterisk (*). Definitions from draft pro- 
posals and working papers under development by the 
International Standards Organization, Technical Com- 
mittee 97, Subcommittee 1 are identified by the symbol 
(TC97). Definitions from the CCITT Sixth Plenary 
Assembly Orange Book, Terms and Definitions and 
working documents published by the Consultative Com- 
mittee on International Telegraph and Telephone of the 
International Telecommunication Union, Geneva, 1980 
are preceded by the symbol (CCITT/ITU). Definitions 
from published sections of the ISO Vocabulary of Data 
Processing, developed by the International Standards 
Organization, Technical Committee 97, Subcommittee 1 
and from published sections of the ISO Vocabulary of 
Office Machines, developed by subcommittees of ISO 
Technical Committee 95, are preceded by the symbol 
(ISO). 

For abbreviations, the definition usually consists only of 
the words represented by the letters; for complete defi- 
nitions, see the entries for the words. 

Reference Words Used in the Entries 

The following reference words are used in this 
glossary: 

Deprecated term for. Indicates that the term should 
not be used. It refers to a preferred term, which is 
defined. 

Synonymous with. Appears in the commentary of a 
preferred term and identifies less desirable or less 
specific terms that have the same meaning. 

Synonym for. Appears in the commentary of a less 
desirable or less specific term and identifies the 
preferred term that has the same meaning. 

Contrast with. Refers to a term that has an opposed 
or substantively different meaning. 

See. Refers to multiple-word terms that have the 
same last word. 

See also. Refers to related terms that have similar 
(but not synonymous) meanings. 



ACB. (1) In VTAM, access method control block. 
(2) In NCP, adapter control block. 

ACB name. (1) The name of an ACB macroinstruction. 
(2) A name specified in the ACBNAME parameter of a 
VTAM APPL statement. Contrast with network name. 



accept. For a VTAM application program, to establish 
a session with a logical unit (LU) in response to a CINIT 
request from a system services control point (SSCP). 
The session-initiation request may begin when a ter- 
minal user logs on, a VTAM application program issues 
a macroinstruction, or a VTAM operator issues a 
command. See also acquire (1). 

access method. A technique for moving data between 
main storage and input/output devices. 

access method control block (ACB). A control block 
that links an application program to VSAM or VTAM. 

accounting exit routine. In VTAM, an optional installa- 
tion exit routine that collects statistics about session 
initiation and termination. 

ACF/NCP. Advanced Communications Function for the 
Network Control Program. Synonym for NCP. 

ACF/SSP. Advanced Communications Function for the 
System Support Programs. Synonym for SSP. 

ACF/VTAM. Advanced Communications Function for 
the Virtual Telecommunications Access Method. 
Synonym for VTAM. 

acquire. (1) For a VTAM application program, to ini- 
tiate and establish a session with another logical unit 
(LU). The acquire process begins when the application 
program issues a macroinstruction. See also accept. 
(2) To take over resources that were formerly con- 
trolled by an access method in another domain, or to 
resume control of resources that were controlled by 
this domain but released. Contrast with release. See 
also resource takeover. 

activate. To make a resource of a node ready to 
perform the functions for which it was designed. Con- 
trast with deactivate. 

active. (1) The state a resource is in when it has been 
activated and is operational. Contrast with inactive, 
pending, and inoperative.. (2) Pertaining to a major or 
minor node that has been activated by VTAM. Most 
resources are activated as part of VTAM start proc- 
essing or as the result of a VARY ACT command. 

adapter. Hardware card that allows a device, such as 
a PC, to communicate with another*bevice, such as a 
monitor, a printer, or other I/O device. 

adapter control block (ACB). In NCP, a control block 
that contains line control information and the states of 
I/O operations for BSC lines, SS lines, or SDLC links. 
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adaptive session pacing. Synonym for adaptive 
session-level pacing. 

adaptive session-level pacing. A form of session-level 
pacing in which session components exchange pacing 
windows that may vSry in size during the course of a 
session. This allows transmission to adapt dynamically 
to variations in availability and demand of buffers on a 
session by session basis. Session pacing occurs 
within independent stages along the session path 
according to local congestion at the intermediate 
nodes. Synonymous with adaptive session pacing. 
See pacing, session-level pacing, and virtual route 
pacing. 

alert. (1) In SNA, a record sent to a system problem 
management focal point to communicate the existence 
of an alert condition. (2) In the NetView program, a 
high priority event that warrants immediate attention. 
This data base record is generated for certain event 
types that are defined by user-constructed filters. 

alias name. A name defined in a host used to repre- 
sent a logical unit name, logon mode table name, or 
class-of-service name in another network. This name 
is defined to a name translation program when the 
alias name does not match the real name. The alias 
name translation program is used to associate the real 
and alias names. 

allocate. A logical unit (LU) 6.2 application program 
interface (API) verb used to assign a session to a con- 
versation for the conversation's use. Contrast with 
deallocate. 



authorization exit routine. In VTAM, an optional instal- 
lation exit routine that approves or disapproves 
requests for session initiation. 

authorized receiver. In the NetView program, an 
authorized operator who receives all the unsolicited 
and authorized-receiver messages not assigned to a 
specific operator. 

automatic logon. (1) A process by which VTAM auto- 
matically creates a session-initiation request to estab- 
lish a session between two logical units (LUs). The 
session will be between a designated primary logical 
unit (PLU) and a secondary logical unit (SLU) that is 
neither queued for nor in session with another PLU. 
See also controlling application program and control- 
ling logical unit. (2) In VM, a process by which a 
virtual machine is initiated by other than the user of 
that virtual machine. For example, the primary VM 
operator's virtual machine is activated automatically 
during VM initialization. 

automatic reactivation. In the NetView program, the 
activation of a node from the inactive state without any 
action by the network operator. 

available. In VTAM, pertaining to a logical unit that is 
active, connected, enabled, and not at its session limit. 

begin bracket. In SNA, the value (binary 1) of the 
begin-bracket indicator in the request header (RH) of 
the first request in the first chain of a bracket; the value 
denotes the start of a bracket. Contrast with end 
bracket. See also bracket. 



API. Application program interface. 

application program. (1) A program written for or by a 
user that applies to the user's work. (2) A program 
used to connect and communicate with stations in a 
network, enabling users to perform application-oriented 
activities. 

application program identification. The symbolic name 
by which an application program is identified to VTAM. 
It is specified in the APPLID parameter of the ACB 
macroinstruction. 



bidder. In SNA, the LU-LU half-session defined at 
session activation as having to request and receive 
permission from the other LU-LU half-session to begin 
a bracket. Contrast with first speaker. See also 
bracket protocol and contention. 

binary synchronous communication (BSC). (1) Com- 
munication using binary synchronous line discipline. 
(2) A uniform procedure, using a standardized set of 
control characters and control character sequences, for 
synchronous transmission of binary-coded data 
between stations. 



application program interface (API). (1) The formally 
defined programming language interface between an 
IBM system control program or licensed program and 
its user. (2) The interface through which an application 
program interacts with an access method. In VTAM, it 
is the language structure used in control blocks so that 
application programs can reference them and be identi- 
fied to VTAM. 

attaching device. Any device that is physically con- 
nected to a network and can communicate over the 
network. 



bind. In SNA, a request to activate a session between 
two logical units (LUs). See also session activation 
request. Contrast with UNBIND. 

Bill segment. In SNA, the portion of a basic informa- 
tion unit (BIU) that is contained within a path informa- 
tion unit (PIU). It consists of either a request/response 
header (RH) followed by all or a portion of a 
request/response unit (RU), or only a portion of an RU. 

blocking of PIUs. In SNA, an optional function of path 
control that combines multiple path information units 
(PIUs) into a single basic transmission unit (BTU). 
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boundary function. (1) A capability of a subarea node 
to provide protocol support for attached peripheral 
nodes, such as: (a) interconnecting subarea path 
control and peripheral path control elements, (b) per- 
forming session sequence numbering for low-function 
peripheral nodes, and (c) providing session-level 
pacing support. (2) The component that provides these 
capabilities. See also boundary node, network 
addressable unit (NAU), peripheral path control, 
subarea node, and subarea path control. 

boundary node. (1) A subarea node with boundary 
function. See subarea node (including illustration). 
See also boundary function. (2) The programming 
component that performs FID2 (format identification 
type 2) conversion, channel data link control, pacing, 
and channel or device error recovery procedures for a 
locally attached station. These functions are similar to 
those performed by a network control program for an 
NCP-attached station. 

bracket. In SNA, one or more chains of request units 
(RUs) and their responses that are exchanged between 
the two LU-LU half-sessions and that represent a trans- 
action between them. A bracket must be completed 
before another bracket can be started. Examples of 
brackets are data base inquiries/replies, update trans- 
actions, and remote job entry output sequences to work 
stations. See also begin bracket and end bracket. 

bracket protocol. In SNA, a data flow control protocol 
in which exchanges between the two LU-LU 
half-sessions are achieved through the use of brackets, 
with one LU designated at session activation as the first 
speaker and the other as the bidder. The bracket pro- 
tocol involves bracket initiation and termination rules. 
See also bidder and first speaker. 

browse. A way of looking at a file that does not allow 
you to change it. 

BSC. Binary synchronous communication. 



CCS. Console communication services. 

CDRM. Cross-domain resource manager. 

CDRSC. Cross-domain resource. . 

channel. * A path along which signals can be sent, for 
example, data channel, output channel. See data 
channel and input/output channel. See also link. 

channel-attached. (1) Pertaining to the attachment of 
devices directly by input/output channels to a host 
processor. (2) Pertaining to devices attached to a con- 
trolling unit by cables, rather than by telecommuni- 
cation lines. Contrast with link-attached. Synonymous 
with local. 

channel link. A System/370 I/O channel to control unit 
interface that has an SNA network address. A channel 
link can be either a subarea link or a peripheral link. 
See also link and subarea link. 

class of service (COS), in SNA, a designation of the 
path control network characteristics, such as path 
security, transmission priority, and bandwidth, that 
apply to a particular session. The end user designates 
class of service at session initiation by using a sym- 
bolic name that is mapped into a list of virtual routes, 
any one of which can be selected for the session to 
provide the requested level of service. 

CLIST. Command list. 

CMS. Conversational Monitor System. 

CNM. Communication network management. 

code point. In the NetView/PC program and in the 
NetView program, a 1- or 2-byte hexadecimal value that 
indexes a text string stored at an alert receiver and is 
used by the alert receiver to create displays of alert 
information. 



buffer. A portion of storage for temporarily holding 
input or output data. 

call. (1) * (ISO) The action of bringing a computer 
program, a routine, or a subroutine into effect, usually 
by specifying the entry conditions and jumping to an 
entry point. (2) To transfer control to a procedure, 
program, routine, or subroutine. (3) The actions nec- 
essary to make a connection between two stations. 
(4) To attempt to contact a user, regardless of whether 
the attempt is successful. 

CALLOUT. The logical channel type on which the data 
terminal equipment (DTE) can send a call, but cannot 
receive one. 

calling. * (ISO) The process of transmitting selection 
signals in order to establish a connection between data 
stations. 



command. (1) A request from a terminal for the per- 
formance of an operation or the execution of a partic- 
ular program. (2) In SNA, any field set in the 
transmission header (TH), request header (RH), and 
sometimes portions of a request unit (RU), that initiates 
an action or that begins a protocol; for example: (a) 
Bind Session (session-control request unit), a 
command that activates an LU-LU session, (b) the 
change-direction indicator in the RH of the last RU of a 
chain, (c) the virtual route reset window indicator in a 
FID4 transmission header. See also VTAM operator 
command. 

command facility. The component of the NetView 
program that is a base for command processors that 
can monitor, control, automate, and improve the opera- 
tion of a network. 
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command list. A list of commands and statements 
designed to perform a specific function for the user. 
Command lists can be written in REXX or in NetView 
command list language. 

command procedure: Either a command list or a 
command processor. See also command list and 
command processor. 

command processor. (1) A program that performs an 
operation specified by a command. (2) In the NetView 
program, a user-written module designed to perform a 
specific function. Command processors, which can be 
written in assembler or a high-level language (HLL), 
are invoked as commands. 

communication line. Deprecated term for telecommu- 
nication line and transmission line. 

communication management configuration host node. 

The type 5 host processor in a communication manage- 
ment configuration that does all network-control func- 
tions in the network except for the control of devices 
channel-attached to data hosts. Synonymous with com- 
munication management host. Contrast with data host 
node. 

communication management host. Synonym for com- 
munication management configuration host node. Con- 
trast with data host. 

communication network management (CNM). The 

process of designing, installing, operating, and man- 
aging the distribution of information and controls 
among end users of communication systems. 

communication network management (CNM) applica- 
tion program. A VTAM application program that issues 
and receives formatted management services request 
units for physical units. For example, the NetView 
program. 

communication network management (CNM) interface. 

The interface that the access method provides to an 
application program for handling data and commands 
associated with communication system management. 
CNM data and commands are handled across this inter- 
face. 

communication network management (CNM) 
processor. A program that manages one of the func- 
tions of a communications system. A CNM processor is 
executed under control of the NetView program. 

component. A command that (a) controls the termi- 
nal's screen (using the DSIPSS macro 
(TYPE = ASYPANEL) or the VIEW command), (b) allows 
the operator to enter NetView commands, and (c) can 
resume when such commands are complete. 

composite end node (CEN). A group of nodes made up 
of a single type 5 node and its subordinate type 4 nodes 



that together support type 2.1 protocols. To a type 2.1 
node, a CEN appears as one end node. For example, 
NCP and VTAM act as a composite end node. 

configuration. (1) (TC97) The arrangement of a com- 
puter system or network as defined by the nature, 
number, and the chief characteristics of its functional 
units. The term may refer to a hardware or a software 
configuration. (2) The devices and programs that 
make up a system, subsystem, or network. (3) In CCP, 
the arrangement of controllers, lines, and terminals 
attached to an IBM 3710 Network Controller. Also, the 
collective set of item definitions that describe such a 
configuration. 

configuration services. In SNA, one of the types of 
network services in the control point (CP) and in the 
physical unit (PU); configuration services activate, 
deactivate, and maintain the status of physical units, 
links, and link stations. Configuration services also 
shut down and restart network elements and modify 
path control routing tables and address-translation 
tables. See also maintenance services, management 
services, network services, and session services. 

connected. In VTAM, pertaining to a physical unit (PU) 
or logical unit (LU) that has an active physical path to 
the host processor containing the system services 
control point (SSCP) that controls the PU or LU. 

connection. Synonym for physical connection. 

console communications services (CCS). The SNA 

facility that acts as an interface between the control 
program and the VSCS component of VTAM for VM. 

contention. A situation in which two logical units (LUs) 
that are connected by an LU 6.2 session both attempt to 
allocate the session for a conversation at the same 
time. The control operator assigns "winner" and 
"loser" status to the LUs so that processing may con- 
tinue on an orderly basis. The contention loser 
requests permission from the contention winner to allo- 
cate a conversation on the session, and the contention 
winner either grants or rejects the request. See also 
bidder. 

control point (CP). (1) A system services control point 
(SSCP) that provides hierarchical control of a group of 
nodes in a network. (2) A control point (CP) local to a 
specific node that provides control of that node, either 
in the absence of SSCP control (for type 2.1 nodes 
engaged in peer to peer communication) or to supple- 
ment SSCP control. 

control program (CP). The VM operating system that 
manages the real processor's resources and is respon- 
sible for simulating System/370s for individual users. 

controlling application program. In VTAM, an applica- 
tion program with which a secondary logical unit (other 
than an application program) is automatically put in 
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session whenever the secondary logical unit is avail- 
able. See also automatic logon and controlling logical 
unit. 

controlling logical unit. In VTAM, a logical unit with 
which a secondary logical unit (other than an applica- 
tion program) is automatically put in session whenever 
the secondary logical unit is available. A controlling 
logical unit can be either an application program or a 
device-type logical unit. See also automatic logon and 
controlling application program. 

control statement. A statement in a command list that 
controls the processing sequence of the command list 
or allows the command list to send messages to the 
operator and receive input from the operator. 

conversation. In SNA, a logical connection between 
two transaction programs using an LU 6.2 session. 
Conversations are delimited by brackets to gain exclu- 
sive use of a session. 

Conversational Monitor System (CMS). A VM applica- 
tion program for general interactive time sharing, 
problem solving, and program development. 

COS. Class of service. 

coupler. A hardware device that connects a modem to 
a public phone system in much the same way that a 
telephone does. 

CP. (1) Control program. (2) Control point. 

cross-domain, in SNA, pertaining to control of 
resources involving more than one domain. 

cross-domain resource (CDRSC). A resource owned 
by a cross-domain resource manager (CDRM) in 
another domain but known by the CDRM in this domain 
by network name and associated CDRM. 

cross-domain resource manager (CDRM). In VTAM, 
the function in the system services control point (SSCP) 
that controls initiation and termination of cross-domain 
sessions. 

cross-network. In SNA, pertaining to control or 
resources involving more than one SNA network. 

cross-network session. An LU-LU or SSCP-SSCP 
session whose path traverses more than one SNA 
network. 

DASD. Direct access storage device. 

data channel. Synonym for input/output channel. See 
channel. 

data circuit-terminating equipment (DCE). (TC97) The 
equipment installed at the user's premises that pro- 
vides all functions required to establish, maintain, and 



terminate a connection, and the signal conversion and 
coding between the data terminal equipment (DTE) and 
the line. The DCE may be separate equipment or an 
integral part of other equipment. - 

data host. Synonym for data host node. Contrast with 
communication management configuration host. 

data host node. In a communication management con- 
figuration, a type 5 host node that is dedicated to proc- 
essing applications and does not control network 
resources, except for its channel-attached or communi- 
cation adapter-attached devices. Synonymous with 
data host. Contrast with communication management 
configuration host node. 

data link. In SNA, synonym for link. 

data link control (DLC) layer. In SNA, the layer that 
consists of the link stations that schedule data transfer 
over a transmission medium connecting two nodes and 
perform error control for the link connection. Examples 
of data link control are SDLC for serial-by-bit link con- 
nection and data link control for the System/370 
channel. 

data services command processor (DSCP). A compo- 
nent that structures a request for recording and 
retrieving data in the application program's data base 
and for soliciting data from a device in the network. 

data services task (DST). The NetView subtask that 
gathers, records, and manages data in a VSAM file 
and/or a network device that contains network manage- 
ment information. 

data terminal equipment (DTE). (TC97) That part of a 
data station that serves as a data source, data link, or 
both, and provides for the data communication control 
function according to protocols. 

data set. The major unit of data storage and retrieval, 
consisting of a collection of data in one of several pre- 
scribed arrangements and described by control infor- 
mation to which the system has access* 

data types. In the NetView program, a concept to 
describe the organization of panels. Data types are 
defined as alerts, events, and statistics. Data types are 
combined with resource types and display types to 
describe NetView's display organization. See also 
display types and resource types. 

DBCS. Double-byte character set. 

DCE. Data circuit-terminating equipment. 

deactivate. To take a resource of a node out of 
service, rendering it inoperable, or to place it in a state 
in which it cannot perform the functions for which it was 
designed. Contrast with activate. 
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deallocate. A logical unit (LU) 6.2 application program 
interface (API) verb that terminates a conversation, 
thereby freeing the session for a future conversation. 
Contrast with allocate. 

definite response (DB). In SNA, a value in the 
form-of-response-requested field of the request header. 
The value directs the receiver of the request to return a 
response unconditionally, whether positive or negative, 
to that request. Contrast with exception response and 
no response. 

definition statement. (1) In VTAM, the statement that 
describes an element of the network. (2) In NCP, a 
type of instruction that defines a resource to the NCP. 
See Figure 1, Figure 2, and Figure 3. See also macro- 
instruction. 
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device. An input/output unit such as a terminal, 
display, or printer. See attaching device. 

direct access storage device (DASD). A device in 
which the access time is effectively independent of the 
location of the data. For example, a disk. 

directory. In VM, a control program (CP) disk that 
defines each virtual machine's normal configuration. 

disabled. In VTAM, pertaining to a logical unit (LU) 
that has indicated to its system services control point 
(SSCP) that it is temporarily not ready to establish 
LU-LU sessions. An initiate request for a session with 
a disabled logical unit (LU) can specify that the session 
be queued by the SSCP until the LU becomes enabled. 
The LU can separately indicate whether this applies to 
its ability to act as a primary logical unit (PLU) or a sec- 
ondary logical unit (SLU). See also enabled and inhib- 
ited. 

display. (1) To present information for viewing, 
usually on a terminal screen or a hard-copy device. 
(2) A device or medium on which information is pre- 
sented, such as a terminal screen. (3) Deprecated 
term for panel. 

display levels. Synonym for display types. 

display types. In the NetView program, a concept to 
describe the organization of panels. Display types are 
defined as total, most recent, user action, and detail. 
Display types are combined with resource types and 
data types to describe NetView's panel organization. 
See data types and resource types. Synonymous with 
display levels- 
domain. (1) An access method, its application pro- 
grams, communication controllers, connecting lines, 
modems, and attached terminals. (2) In SNA, a system 
services control point (SSCP) and the physical units 
(PUs), logical units (LUs), links, link stations, and all the 
associated resources that the SSCP has the ability to 
control by means of activation requests and deacti- 
vation requests. See system services cuntrol point 
domain and type 2.1 node control point domain.. See 
also single-domain network and multiple-domain 
network. 

domain operator. In a multiple-domain network, the 
person or program that controls the operation of the 
resources controlled by one system services control 
point. Contrast with network operator (2). 

double-byte character set (DBCS). A character set, 
such as Japanese, in which each character is repres- 
ented by a two-byte code. 

downstream. In the direction of data flow from the host 
to the end user. Contrast with upstream. 
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drop. In the IBM Token-Ring Network, a cable that 
leads from a faceplate to the to the distribution panel in 
a wiring closet. When the IBM Cabling System is used 
with the IBM Token-Ring Network, a drop may form part 
of a lobe. 

DSCP. Data services command processor. 

DST. Data services task. 

DTE. Data terminal equipment. 

dump. (1) Computer printout of storage. (2) To write 
the contents of all or part of storage to an external 
medium as a safeguard against errors or in connection 
with debugging. (3) (ISO) Data that have been 
dumped. 

duplex. * In data communication, pertaining to a 
simultaneous two-way independent transmission in 
both directions. Synonymous with full duplex. Contrast 
with half duplex. 

EBCDIC. * Extended binary-coded decimal inter- 
change code. A coded character set consisting of 8-bit 
coded characters. 

echo. The return of characters to the originating SS 
device to verify that a message was sent correctly. 

ECL. Electronic cabling link. 

element. (1) A field in the network address. (2) The 
particular resource within a subarea identified by the 
element address. See also subarea. 

Emulation Program (EP). An IBM control program that 
allows a channel-attached 3705 or 3725 communication 
controller to emulate the functions of an IBM 2701 Data 
Adapter Unit, an IBM 2702 Transmission Control, or an 
IBM 2703 Transmission Control. See also network 
control program. 

enabled. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is now ready to establish LU-LU sessions. 
The LU can separately indicate whether this prevents it 
from acting as a primary logical unit (PLU) or as a sec- 
ondary logical unit (SLU). See also disabled and inhib- 
ited. 

end bracket. In SNA, the value (binary 1) of the end 
bracket indicator in the request header (RH) of the first 
request of the last chain of a bracket; the value denotes 
the end of the bracket. Contrast with begin bracket. 
See also bracket. 

end node. A type 2.1 node that does not provide any 
intermediate routing or session services to any other 
node. For example, APPC/PC is an end node. See 
composite end node, node, and type 2.1 node. 



entry point. An SNA node that provides distributed 
network management support. It may be a type 2, type 
2.1, type 4, or type 5 node. It sends SNA-formatted 
network management data about itself and the 
resources it controls to a focal point for centralized 
processing, and it receives and executes focal point ini- 
tiated commands to manage and control its resources. 

EP. Emulation Program. 

ER. (1) Explicit route. (2) Exception response. 

error-to-traffic (E/T). The number of temporary errors 
compared to the traffic associated with a resource. 

E/T. Error-to-traffic. 

event. (1) In the NetView program, a record indicating 
irregularities of operation in physical elements of a 
network. (2) An occurrence of significance to a task; 
typically, the completion of an asynchronous operation, 
such as an input/output operation. 

exception response (ER). In SNA, a value in the 
form-of-response-requested field of a request header 
(RH). An exception response is sent only if a request is 
unacceptable as received or cannot be processed. 
Contrast with definite response and no response. See 
also negative response. 

EXEC. In a VM operating system, a user-written 
command file that contains CMS commands, other 
user-written commands, and execution control state- 
ments, such as branches. 

exit routine. Any of several types of special-purpose 
user-written routines. See accounting exit routine, 
authorization exit routine, logon-interpret routine, 
virtual route selection exit routine, EXLST exit routine, 
and RPL exit routine. 

EXLST exit routine. In VTAM, a routine whose address 
has been placed in an exit list (EXLST) control block. 
The addresses are placed there with the EXLST macro- 
instruction, and the routines are named according to 
their corresponding operand; hence DFASY exit 
routine, TPEND exit routine, RELREQ exit routine, and 
so forth. All exit list routines are coded by the VTAM 
application programmer. Contrast with RPL exit 
routine. 

explicit route (ER). In SNA, the path control network 
elements, including a specific set of one or more trans- 
mission groups, that connect two subarea nodes. An 
explicit route is identified by an origin subarea 
address, a destination subarea address, an explicit 
route number, and a reverse explicit route number. 
Contrast with virtual route (VR). See also path and 
route extension. 

FDX. Full duplex. 
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feature. A particular part of an IBM product that a cus- 
tomer can order separately. 

filter. In the NetView program, a function that limits 
the data that is to be recorded on the data base and 
displayed at the terminal. See recording filter and 
viewing filter. 

first speaker. In SNA, the LU-LU half-session defined 
at session activation as: (1) able to begin a bracket 
without requesting permission from the other LU-LU 
half-session to do so, and (2) winning contention if both 
half-sessions attempt to begin a bracket simultane- 
ously. Contrast with bidder. See also bracket protocol. 

How control. In SNA, the process of managing the rate 
at which data traffic passes between components of the 
network. The purpose of flow control is to optimize the 
rate of flow of message units, with minimum congestion 
in the network; that is, to neither overflow the buffers at 
the receiver or at intermediate routing nodes, nor leave 
the receiver waiting for more message units. See also 
adaptive session-level pacing, pacing, session-level 
pacing, and virtual route pacing. 

focal point. An entry point that provides centralized 
management and control for other entry points for one 
or more network management categories. 

frame. (1) The unit of transmission in some local area 
networks, including the IBM Token-Ring Network. It 
includes delimiters, control characters, information, 
and checking characters. (2) In SDLC, the vehicle for 
every command, every response, and all information 
that is transmitted using SDLC procedures. 

full duplex (FDX). Synonym for duplex. 

gateway. (1) The combination of machines and pro- 
grams that provide address translation, name trans- 
lation, and system services control point (SSCP) 
rerouting between independent SNA networks to allow 
those networks to communicate. A gateway consists of 
one gateway NCP and at least one gateway SSCP. 
(2) In the IBM Token-Ring Network, a device and its 
associated software that connect a local area network 
to another local area network or a host that uses dif- 
ferent logical link protocols. 

generation. The process of assembling and link 
editing definition statements so that resources can be 
identified to all the necessary programs in a network. 

generic alert. Encoded alert information that uses 
code points (defined by IBM and possibly customized 
by users or application programs) stored at an alert 
receiver, such as the-NetView program. 

generic unbind. Synonym for session deactivation 
request. 



group. In the NetView/PC program, to identify a set of 
application programs that are to run concurrently. 

half-duplex. * In data communication, pertaining to an 
alternate, one way at a time, independent transmission. 
Contrast with duplex. 

half-session. In SNA, a component that provides func- 
tion management data (FMD) services, data flow 
control, and transmission control for one of the ses- 
sions of a network addressable unit (NAU). See also 
primary half-session and secondary half-session. 

hard copy. A printed copy of machine output in a visu- 
ally readable form; for example, printed reports, 
listings, documents, summaries, or network logs. 

hard-copy task (HCT). The NetView subtask that con- 
trols the passage of data between the NetView program 
and the hard-copy device. 

hardware monitor. The component of the NetView 
program that helps identify network problems, such as 
hardware, software, and microcode, from a central 
control point using interactive display techniques. 

help panel. An online display that tells you how to use 
a command or another aspect of a product. See task 
panel. 

High Performance Option (HPO). A licensed program 
that is an extension of VM/SP. It provides performance 
and operation enhancements for large system environ- 
ments. 

host node. A node providing an application program 
interface (API) and a common application interface. 
See boundary node, node, peripheral node, subarea 
host node, and subarea node. See also boundary func- 
tion and node type. 

HPO. High Performance Option. 

immediate command. In the NetView program, a 
command (such as GO, CANCEL, or RESET) that can be 
executed while a regular command is being processed. 

inactive. Describes the state of a resource that has not 
been activated or for which the VARY INACT command 
has been issued. Contrast with active. See also inop- 
erative. 



information (I) format. 

transfer. 



A format used for information 



inhibited. In VTAM, pertaining to a logical unit (LU) 
that has indicated to its system services control point 
(SSCP) that it is not ready to establish LU-LU sessions. 
An initiate request for a session with an inhibited LU 
will be rejected by the SSCP. The LU can separately 
indicate whether this applies to its ability to act as a 
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primary logical unit (PLU) or as a secondary logical 
unit (SLU). See also enabled and disabled. 

inoperative. The condition of a resource that has been 
active, but is not. The resource may have failed, 
received an INOP request, or is suspended while a 
reactivate command is being processed. See also 
inactive. 

Input/output channel. (1) (ISO) In a data processing 
system, a functional unit that handles the transfer of 
data between internal and peripheral equipment. (2) In 
a computing system, a functional unit, controlled by a 
processor, that handles the transfer of data between 
processor storage and local peripheral devices. Syn- 
onymous with data channel. See channel. See also 
link. 



interconnected networks. 

gateways. 



SNA networks connected by 



interface. * A shared boundary. An interface might be 
a hardware component to link two devices or it might 
be a portion of storage or registers accessed by two or 
more computer programs. 

item. In CCP, any of the components, such as commu- 
nication controllers, lines, cluster controllers, and ter- 
minals, that comprise an IBM 3710 Network Controller 
configuration. 

Kanji. An ideographic character set used in Japanese. 
See also double-byte character set. 

Katakana. A phonetic character set used in Japanese. 
It belongs to a single-byte character set. 

keyword. (1) (TC97) A lexical unit that, in certain con- 
texts, characterizes some language construction. (2) * 
One of the predefined words of an artificial language. 
(3) One of the significant and informative words in a 
title or document that describes the content of that doc- 
ument. (4) A name or symbol that identifies a param- 
eter. (5) A part of a command operand that consists of 
a specific character string (such as DSNAME = ). See 
also definition statement and keyword operand. Con- 
trast with positional operand. 

keyword operand. An operand that consists of a 
keyword followed by one or more values (such as 
DSNAME = HELLO). See also definition statement. 
Contrast with positional operand. 

keyword parameter. A parameter that consists of a 
keyword followed by one or more values. 

LAN. An industry-wide acronym for local area 
network. 

LCC. Link connection component. 



LCS. Link connection subsystem. 

line. See communication line. 

link. In SNA, the combination of the link connection 
and the link stations joining network nodes; for 
example: (1) a System/370 channel and its associated 
protocols, (2) a serial-by-bit connection under the 
control of Synchronous Data Link Control (SDLC). A 
link connection is the physical medium of transmission. 
A link, however, is both logical and physical. Synony- 
mous with data link. See Figure 4 on page 156. 

link-attached. Pertaining to devices that are physically 
connected by a telecommunication line. Contrast with 
channel-attached. Synonymous with remote. 

link connection. In SNA, the physical equipment pro- 
viding two-way communication between one link station 
and one or more other link stations; for example, a tele- 
communication line and data circuit terminating equip- 
ment (DCE). 

link connection component (LCC). Components of the 
link that perform functions for the physical layer of the 
link. 

link connection segment. A portion of the configuration 
that is located between two resources listed consec- 
utively in the service point command service (SPCS) 
query link configuration request list. 

link connection subsystem (LCS). The sequence of link 
connection components (LCCs) that belong to a link 
connection and are managed by one LCSM. 

Link Problem Determination Aid (LPDA). A series of 
testing procedures initiated by the NetView program 
that provide modem status, attached device status, and 
the overall quality of a communications link. 

link station. (1) In SNA, the combination of hardware 
and software that allows a node to attach to and 
provide control for a link. (2) In VTAM, a named 
resource within a subarea node that represents 
another subarea node that is attached by a subarea 
link. In the resource hierarchy, the link station is sub- 
ordinate to the subarea link. 

load module. (ISO) A program unit that is suitable for 
loading into main storage for execution; it is usually the 
output of a linkage editor. 

local. Pertaining to a device that is attached to a con- 
trolling unit by cables, rather than by a telecommuni- 
cation line. Synonymous with channel-attached. 

local address. In SNA, an address used in a peripheral 
node in place of an SNA network address and trans- 
formed to or from an SNA network address by the 
boundary function in a subarea node. 
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Figure 4. Links and Path Controls 

local area network (LAN). (1) A network in which a set 
of devices are connected to one another for communi- 
cation and that can be connected to a larger network. 
See also token ring. (2) A network in which communi- 
cations are limited to a moderately sized geographic 
area such as a single office building, warehouse, or 
campus, and which do not generally extend across 
public rights-of-way. Contrast with wide area network. 



logical unit (LU). In SNA, a port through which an end 
user accesses the SNA network and the functions pro- 
vided by system services control points (SSCPs). An 
LU can support at least two sessions— one with an 
SSCP and one with another LU— and may be capable of 
supporting many sessions with other LUs. See also 
network addressable unit (NAU), peripheral LU, phys- 
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leal unit (PU), system services control point (SSCP), 
primary logical unit (PLU), and secondary logical unit 
(SLU). 

logical unit (LU) services. In SNA, capabilities in a 
logical unit to: (1) receive requests from an end user 
and, in turn, issue requests to the system services 
control point (SSCP) in order to perform the requested 
functions, typically for session initiation; (2) receive 
requests from the SSCP, for example to activate LU-LU 
sessions via Bind Session requests; and (3) provide 
session presentation and other services for LU-LU ses- 
sions. See also physical unit (PU) services. 

logical unit (LU) 6.2. A type of logical unit that sup- 
ports general communication between programs in a 
distributed processing environment. LU 6.2 is charac- 
terized by (1) a peer relationship between session part- 
ners, (2) efficient utilization of a session for multiple 
transactions, (3) comprehensive end-to-end error proc- 
essing, and (4) a generic application program interface 
(API) consisting of structured verbs that are mapped 
into a product implementation. 

logoff. In VTAM, an unformatted session termination 
request. 



LU-LU session, in SNA, a session between two logical 
units (LUs) in an SNA network. It provides communi- 
cation between two end users, or between an end user 
and an LU services component. . 

LU-LU session type. A deprecated term for LU type. 

LU 6.2. Logical unit 6.2. 

macroinstruction. (1) An instruction that when exe- 
cuted causes the execution of a predefined sequence of 
instructions in the same source language. (2) In 
assembler programming, an assembler language state- 
ment that causes the assembler to process a prede- 
fined set of statements called a macro definition. The 
statements normally produced from the macro defi- 
nition replace the macroinstruction in the program. 
See also definition statement. 

maintenance services. In SNA, one of the types of 
network services in system services control points 
(SSCPs) and physical units (PUs). Maintenance ser- 
vices provide facilities for testing links and nodes and 
for collecting and recording error information. See 
also configuration services, management services, 
network services, and session services. 



log on. To initiate a session. 

logon. In VTAM, an unformatted session initiation 
request for a session between two logical units. See 
automatic logon and simulated logon. See also 
session-initiation request. 

logon mode. In VTAM, a subset of session parameters 
specified in a logon mode table for communication with 
a logical unit. See also session parameters. 

logon-interpret routine. In VTAM, an installation exit 
routine, associated with an interpret table entry, that 
translates logon information. It may also verify the 
logon. 

LPDA. Link Problem Determination Aid. 

LU. Logical unit. 

LU type. In SNA, the classification of an LU-LU session 
in terms of the specific subset of SNA protocols and 
options supported by the logical units (LUs) for that 
session, namely: 

The mandatory and optional values allowed in the 
session activation request. 

The usage of data stream controls, function man- 
agement headers (FMHs), request unit (RU) param- 
eters, and sense codes. 

Presentation services protocols such as those 
associated with FMH usage. 

LU types 0, 1, 2, 3, 4, 6.1, 6.2, and 7 are defined. 



major node. In VTAM, a set of resources that can be 
activated and deactivated as a group. See node and 
minor node. 

management services. In SNA, one of the types of 
network services in control points (CPs) and physical 
units (PUs). Management services are the services 
provided to assist in the management of SNA networks, 
such as problem management, performance and 
accounting management, configuration management 
and change management. See also configuration ser- 
vices, maintenance services, network services, and 
session services. 

Medium Access Control (MAC). The sublayer of DLC 
that supports medium-dependent functions and uses 
the services of the physical layer to provide services to 
Logical Link Control (LLC). The MAC sublayer includes 
the medium access port. 

medium access control (MAC) procedure. (TC97) In a 
local area network, the part of the protocol that governs 
access to the transmission medium independently of 
the physical characteristics of the medium, but takes 
into account the topological aspects of the network, in 
order to enable the exchange of data between data 
stations. 

message. (1) (TC97) A group of characters and 
control bit sequences transferred as an entity. (2) In 
VTAM, the amount of function management data (FMD) 
transferred to VTAM by the application program with 
one SEND request. 
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migration, installing a new version or release of a 
program when an earlier version or release is already 
in place. 

minor node. In VTAM, a uniquely-defined resource 
within a major node. See node and major node. 

modem. A device that modulates and demodulates 
signals transmitted over data communication facilities. 
The term is a contraction for modulator-demodulator. 

mode name. A symbolic name for a set of session 
characteristics. For LU 6.2, a mode name and a 
partner LU name together define a group of parallel 
sessions having the same characteristics. 

module. * A program unit that is discrete and identifi- 
able with respect to compiling, combining with other 
units, and loading; for example, the input to or output 
from an assembler, compiler, linkage editor, or execu- 
tive routine. 

monitor. In the IBM Token-Ring Network, the function 
required to initiate the transmission of a token on the 
ring and to provide soft-error recovery in case of lost 
tokens, circulating frames, or other difficulties. The 
capability is present in all ring stations. 

multiple-domain network. In SNA, a network with more 
than one system services control point (SSCP). Con- 
trast with single-domain network. 

Multiple Virtual Storage (MVS). An IBM licensed 
program whose full name is the Operating 
System/Virtual Storage (OS/VS) with Multiple Virtual 
Storage/System Product for System/370. It is a soft- 
ware operating system controlling the execution of pro- 
grams. 

Multiple Virtual Storage for Extended Architecture 
(MVS/XA). An IBM licensed program whose full name 
is the Operating System/Virtual Storage (OS/VS) with 
Multiple Virtual Storage/System Product for Extended 
Architecture. Extended architecture allows 31-bit 
storage addressing. MVS/XA is a software operating 
system controlling the execution of programs. 

MVS. Multiple Virtual Storage operating system. 

MVS/XA. Multiple Virtual Storage for Extended Archi- 
tecture operating system. 

NAM. network asset management facility 

name translation. In BNA network interconnection, 
converting logical untt names, logon mode table 
names, and class-of-service names used in one 
network into equivalent names to be used in another 
network. This function can be provided through the 
NetView program and invoked by a gateway system 
services control point (SSCP) when necessary. See 
also alias name. 



NAU. Network addressable unit. 

NCCF. Network Communications Control Facility. 

NCP. (1) Network Control Program (IBM licensed 
program). Its full name is Advanced Communications 
Function for the Network Control Program. Synony- 
mous with ACF/NCP. (2) Network control program 
(general term). 

NCP major node. In VTAM, a set of minor nodes 
representing resources, such as lines and peripheral 
nodes, controlled by a network control program. See 
major node. 

negative response (NR). In SNA, a response indicating 
that a request did not arrive successfully or was not 
processed successfully by the receiver. Contrast with 
positive response. See exception response. 

NetView. A system 370-based IBM licensed program 
used to monitor a network, manage it, and diagnose its 
problems. 

NetView command list language. An interpretive lan- 
guage unique to the NetView program that is used to 
write command lists. 

NetView-NetView task (NNT). The task under which a 
cross-domain NetView operator session runs. See 
operator station task. 

NetView/PC. A PC-based IBM licensed program 
through which application programs can be used to 
monitor, manage, and diagnose problems in IBM 
Token-Ring networks, non-SNA communication 
devices, and voice networks. 

network. (1) (TC97) An interconnected group of 
nodes. (2) In data processing, a user application 
network. See path control network, public network, 
SNA network, subarea network, type 2.1 network, and 
user-application network. 

network address. In SNA, an address, consisting of 
subarea and element fields, that identifies a link, a link 
station, or a network addressable unit. Subarea nodes 
use network addresses; peripheral nodes use local 
addresses. The boundary function in the subarea node 
to which a peripheral node is attached transforms local 
addresses to network addresses and vice versa. See 
local address. See also network name. 

network addressable unit (NAU). In SNA, a logical unit, 
a physical unit, or a system services control point. It is 
the origin or the destination of information transmitted 
by the path control network. Each NAU has a network 
address that represents it to the path control network. 
See also network name, network address, and path 
control network. 
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Network Communications Control Facility (NCCF). An 

IBM licensed program that is a base for command 
processors that can monitor, control, automate, and 
improve the operations of a network. Its function is 
included and enhanced in NetView's command facility. 

Network Control Program (NCP). An IBM licensed 
program that provides communication controller 
support for single-domain, multiple-domain, and inter- 
connected network capability. Its full name is 
Advanced Communications Function for the Network 
Control Program. 

network control program. A program, generated by 
the user from a library of IBM-supplied modules, that 
controls the operation of a communication controller. 

network identifier (network ID). The network name 
defined to NCPs and hosts to indicate the name of the 
network in which they reside. It is unique across all 
communicating SNA networks, communication among 
domains. 

network log. A file that contains all messages proc- 
essed by the NetView program. 

Network Logical Data Manager (NLDM). An IBM 

licensed program that collects and correlates 
session-related data and provides online access to this 
information. It runs as an NCCF communication 
network management (CNM) application program. Its 
function is included and enhanced in NetView's session 
monitor. 

network management vector transport (NMVT). A 

management services request/response unit (RU) that 
flows over an active session between physical unit 
management services and control point management 
services (SSCP-PU session). 

network name. (1) In SNA, the symbolic identifier by 
which end users refer to a network addressable unit 
(NAU), a link, or a link station. See also network 
address. (2) In a multiple-domain network, the name 
of the APPL statement defining a VTAM application 
program is its network name and it must be unique 
across domains. Contrast with ACB name. See unin- 
terpreted name. 

network operator. (1) A person or program respon- 
sible for controlling the operation of all or part of a 
network. (2) The person or program that controls all 
the domains in a multiple-domain network. Contrast 
with domain operator. 

Network Problem Determination Application (NPDA). 

An IBM licensed program that helps you identity 
network problems, such as hardware, software, and 
microcode, from a central control point using interac- 
tive display techniques. It runs as an NCCF communi- 
cation network management (CNM) application 



program. Its function is included and enhanced in 
NetView's hardware monitor. 

network services (NS). In SNA, the services within 
network addressable units (NAUs) that control network 
operation through SSCP-SSCP, SSCP-PU, and SSCP-LU 
sessions. See configuration services, maintenance 
services, management services, and session services. 

NLDM. Network Logical Data Manager. 

NMVT. Network management vector transport. 

NNT. NetView-NetView task. 

node. (1) In SNA, an endpoint of a link or junction 
common to two or more links in a network. Nodes can 
be distributed to host processors, communication con- 
trollers, cluster controllers, or terminals. Nodes can 
vary in routing and other functional capabilities. See 
boundary node, host node, peripheral node, and 
subarea node (including illustration). (2) In VTAM, a 
point in a network defined by a symbolic name. See 
major node and minor node. 

node name. In VTAM, the symbolic name assigned to 
a specific major or minor node during network defi- 
nition. 

node type. In SNA, a designation of a node according 
to the protocols it supports and the network address- 
able units (NAUs) that it can contain. Five types are 
defined: 1, 2.0, 2.1, 4, and 5. Type 1, type 2.0, and type 
2.1 nodes are peripheral nodes; type 4 and type 5 
nodes are subarea nodes. See also type 2.1 node. 

nonswitched connection. A connection that does not 
have to be established by dialing. Contrast with 
switched connection. 

no response. In SNA, a value in the 
form-of-response-requested field of the request header 
(RH) indicating that no response is to be returned to the 
request, whether or not the request is received and 
processed successfully. Contrast with definite 
response and exception response. 

notify. A network services request that is sent by an 
SSCP to a logical unit (LU) to inform the LU of the status 
of a procedure requested by the LU. 

NPDA. Network Problem Determination Application. 

online. Stored in a computer and accessible from a 
terminal. 

open. (1) In the IBM Token-Ring Network, to make an 
adapter ready for use. (2) A break in an electrical 
circuit. 

operand. (1) (ISO) An entity on which an operation is 
performed. (2) * That which is operated upon. An 
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operand is usually identified by an address part of an 
instruction. (3) Information entered with a command 
name to define the data on which a command 
processor operates and to control the execution of the 
command processor. (4) An expression to whose 
value an operator is applied. See also definition state- 
ment, keyword, keyword parameter, and parameter. 

operator. (1) In a language statement, the lexical 
entity that indicates the action to be performed on oper- 
ands. (2) A person who operates a machine. See 
network operator. See also definition statement. 

operator profile. In the NetView program, the 
resources and activities a network operator has control 
over. The statements defining these resources and 
activities are stored in a file that is activated when the 
operator logs on. 

operator station task (OST). The NetView task that 
establishes and maintains the online session with the 
network operator. There is one operator station task 
for each network operator who logs on to the NetView 
program. See NetView-NetView task. 

OST. Operator station task. 

pacing. In SNA, a technique by which a receiving com- 
ponent controls the rate of transmission of a sending 
component to prevent overrun or congestion. See 
session-level pacing, send pacing, and virtual route 
(VR) pacing. See also flow control. 

pacing response. In SNA, an indicator that signifies a 
receiving component's readiness to accept another 
pacing group; the indicator is carried in a response 
header (RH) for session-level pacing, and in a trans- 
mission header (TH) for virtual route pacing. 

page. (1) The portion of a panel that is shown on a 
display surface at one time. (2) To move back and 
forth among the pages of a multiple-page panel. See 
also scroll. (3) (ISO) In a virtual storage system, a 
fixed-length block that has a virtual address and that 
can be transferred between real storage and auxiliary 
storage. (4) To transfer instructions, data, or both 
between real storage and external page or auxiliary 
storage. 

panel. (1) A formatted display of information that 
appears on a terminal screen. See also help panel and 
task panel. Contrast with screen. (2) In computer 
graphics, a display image that defines the locations and 
characteristics of display fields on a display surface. 

parameter. (1) (ISO)" A variable that is given a con- 
stant value for a specified application and that may 
denote the application. (2) An item in a menu for 
which the user specifies a value or for which the 
system provides a value when the menu is interpreted. 
(3) Data passed to a program or procedure by a user 



or another program, namely as an operand in a lan- 
guage statement, as an item in a menu, or as a shared 
data structure. See also keyword, keyword parameter, 
and operand. 

parallel sessions. In SNA, two or more concurrently 
active sessions between the same two logical units 
(LUs) using different pairs of network addresses. Each 
session can have independent session parameters. 

path. (1) In SNA, the series of path control network 
components (path control and data link control) that are 
traversed by the information exchanged between two 
network addressable units (NAUs). See also explicit 
route (ER), route extension, and virtual route (VR). 
(2) In VTAM when defining a switched major node, a 
potential dial-out port that can be used to reach that 
node. (3) In the NetView/PC program, a complete line 
in a configuration that contains all of the resources in 
the service point command service (SPCS) query link 
configuration request list. 

path control (PC). The function that routes message 
units between network addressable units (NAUs) in the 
network and provides the paths between them. It con- 
verts the BlUs from transmission control (possibly seg- 
menting them) into path information units (PIUs) and 
exchanges basic transmission units (BTUs) and one or 
more PIUs with data link control. Path control differs 
for peripheral nodes, which use local addresses for 
routing, and subarea nodes, which use network 
addresses for routing. See peripheral path control and 
subarea path control. See also link, peripheral node, 
and subarea node. 

path control (PC) layer. In SNA, the layer that 
manages the sharing of link resources of the SNA 
network and routes basic information units (BlUs) 
through it. See also BIU segment, blocking of PIUs, 
data link control layer, and transmission control layer. 

path control (PC) network. In SNA, the part of the SNA 
network that includes the data link control and path 
control layers. See SNA network and user application 
network. See also boundary function. 

path information unit (PIU). In SNA, a message unit 
consisting of a transmission header (TH) alone, or of a 
TH followed by a basic information unit (BIU) or a BIU 
segment. See also transmission header. 

PC. (1) Path control. (2) Personal Computer. Its full 
name is the IBM Personal Computer. 

performance class. In the NetView program, a 
description of an objective or commitment of perform- 
ance. It consists of a performance class name, 
boundary definitions, response time definition, 
response time ranges, and response time percentage 
objectives. Sessions may be assigned performance 
classes. 
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peripheral host node. A node that provides an applica- 
tion program interface (API) for running application 
programs but does not provide SSCP functions and is 
not aware of the network configuration. The peripheral 
host node does not provide subarea node services. It 
has boundary function provided by its adjacent 
subarea. See boundary node, host node, node, periph- 
eral node, subarea host node, and subarea node. See 
also boundary function and node type. 

peripheral LU. In SNA, a logical unit representing a 
peripheral node. 

peripheral node. In SNA, a node that uses local 
addresses for routing and therefore is not affected by 
changes in network addresses. A peripheral node 
requires boundary-function assistance from an adja- 
cent subarea node. A peripheral node is a physical 
unit (PU) type 1, 2.0, or 2.1 node connected to a 
subarea node with boundary function within a subarea. 
See boundary node, host node, node, peripheral host 
node, subarea host node, and subarea node. See also 
boundary function and node type. 

peripheral path control. The function in a peripheral 
node that routes message units between units with 
local addresses and provides the paths between them. 
See path control and subarea path control. See also 
boundary function, peripheral node, and subarea node. 

peripheral PU. In SNA, a physical unit representing a 
peripheral node. 

Personal Computer (PC). The IBM Personal Computer 
line of products including the 5150 and subsequent 
models. 

physical connection. In VTAM, a point-to-point con- 
nection or multipoint connection. Synonymous with 
connection. 

physical unit (PU). In SNA, a type of network address- 
able unit (NAU). A physical unit (PU) manages and 
monitors the resources (such as attached links) of a 
node, as requested by a system services control point 
(SSCP) through an SSCP-PU session. An SSCP acti- 
vates a session with the physical unit in order to indi- 
rectly manage, through the PU, resources of the node 
such as attached links. See also peripheral PU and 
subarea PU. 

physical unit (PU) services. In SNA, the components 
within a physical unit (PU) that provide configuration 
services and maintenance services for SSCP-PU ses- 
sions. See also logical unit (LU) services. 

PIU. Path information unit. 

PLU. Primary logical unit. 

POI. Programmed operator interface. 



positional operand. An operand in a language state- 
ment that has a fixed position. See also definition 
statement. Contrast with keyword operand. 

positive response. A response indicating that a 
request was received and processed. Contrast with 
negative response. 

PPT. Primary POI task. 

primary half-session. In SNA, the half-session that 
sends the session activation request. See also primary 
logical unit. Contrast with secondary half-session. 

primary logical unit (PLU). In SNA, the logical unit (LU) 
that contains the primary half-session for a particular 
LU-LU session. Each session must have a PLU and 
secondary logical unit (SLU). The PLU is the unit 
responsible for the bind and is the controlling LU for 
the session. A particular LU may contain both primary 
and secondary half-sessions for different active LU-LU 
sessions. Contrast with secondary logical unit (SLU). 

primary POI task (PPT). The NetView subtask that 
processes all unsolicited messages received from the 
VTAM program operator interface (POI) and delivers 
them to the controlling operator or to the command 
processor. The PPT also processes the initial 
command specified to execute when the NetView 
program is initialized and timer request commands 
scheduled to execute under the PPT. 

problem determination. The process of identifying the 
source of a problem; for example, a program compo- 
nent, a machine failure, telecommunication facilities, 
user or contractor-installed programs or equipment, an 
environment failure such as a power loss, or a user 
error. 

profile. In the Conversational Monitor System (CMS) 
or the group control system (GCS), the characteristics 
defined by a PROFILE EXEC file that executes automat- 
ically after the system is loaded into a virtual machine. 
See also operator profile. 

programmed operator interface (POI). A VTAM func- 
tion that allows programs to perform VTAM operator 
functions. 

protocol. (1) (CCITT/ITU) A specification for the 
format and relative timing of information exchanged 
between communicating parties. (2) (TC97) The set of 
rules governing the operation of functional units of a 
communication system that must be followed if commu- 
nication is to be achieved. (3) In SNA, the meanings of, 
and the sequencing rules for, requests and responses 
used for managing the network, transferring data, and 
synchronizing the states of network components. See 
also bracket protocol. Synonymous with line control 
discipline and line discipline. See also link protocol. 

PU. Physical unit. 
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PU type. Physical unit type. 

public network. A network established and operated 
by communication common carriers or telecommuni- 
cation Administrations jor the specific purpose of pro- 
viding circuit-switched, packet switched, and 
leased-circuit services to the public. Contrast with 
user-application network. 

PU-PU flow. In SNA, the exchange between physical 
units (PUs) of network control requests and responses. 

RACF. Resource Access Control Facility. 

RDT. Resource definition table. 

real name. The name by which a logical unit (LU), 
logon mode table, or class-of-service (COS) table is 
known within the SNA network in which it resides. 

receive pacing. In SNA, the pacing of message units 
that the component is receiving. See also send pacing. 

record. (1) (ISO) In programming languages, an 
aggregate that consists of data objects, possibly with 
different attributes, that usually have identifiers 
attached to them. In some programming languages, 
records are called structures. (2) (TC97) A set of data 
treated as a unit. (3) A set of one or more related data 
items grouped for processing. (4) In VTAM, the unit of 
data transmission for record mode. A record repres- 
ents whatever amount of data the transmitting node 
chooses to send. 

recording filter. In the NetView program, the function 
that determines which events, statistics, and alerts are 
stored on a data base. 

regular command. In the NetView program, any VTAM 
or NetView command that is not an immediate 
command and is processed by a regular command 
processor. Contrast with immediate command. 

release. For VTAM, to relinquish control of resources 
(communication controllers or physical units). See also 
resource takeover. Contrast with acquire (2). 

remote. Concerning the peripheral parts of a network 
not centrally linked to the host processor and generally 
using telecommunication lines with public right-of-way. 

remove. In the IBM Token-Ring Network, to take an 
attaching device off the ring. 

request header (RH). Fn SNA, control information pre- 
ceding a request unit (RU). See also request/ response 
header (RH). 

request unit (RU). In SNA, a message unit that con- 
tains control information, end-user data, or both. 



request/response header (RH). In SNA, control infor- 
mation, preceding a request/response unit (RU), that 
specifies the type of RU (request unit or response unit) 
and contains control information associated with that 
RU. 

request/response unit (RU). In SNA, a generic term for 
a request unit or a response unit. See also request unit 
(RU) and response unit. 

reset. On a virtual circuit, reinitialization of data flow 
control. At reset, all data in transit are eliminated. 

resource. (1) Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the proc- 
essing unit, data sets, and control or processing pro- 
grams. (2) In the NetView program, any hardware or 
software that provides function to the network. 

Resource Access Control Facility (RACF). A licensed 
program that provides for access control by identifying 
and verifying users to the system, authorizing access to 
OASO data sets, logging detected unauthorized 
attempts to enter the system, and logging detected 
accesses to protected data sets. 

resource definition table (RDT). In VTAM, a table that 
describes the characteristics of each node available to 
VTAM and associates each node with a network 
address. This is the main VTAM network configuration 
table. 

resource level. In the NetView program, the hierar- 
chical position of a device (and the software contained 
within it) in a data processing system. For example, a 
first-level resource would be the communication con- 
troller, and the second-level resource would be the line 
connected to it. 

resource takeover. In VTAM, action initiated by a 
network operator to transfer control of resources from 
one domain to another. See also acquire (2) and 
release. See takeover. 

resource types. In the NetView program, a concept to 
describe the organization of panels. Resource types 
are defined as central processing unit, channel, control 
unit, and I/O device for one category; and communi- 
cation controller, adapter, link, cluster controller, and 
terminal for another category. Resource types are 
combined with data types and display types to describe 
display organization. See also data types and display 
types. 

response. A reply represented in the control field of a 
response frame. It advises the primary or combined 
station of the action taken by the secondary or other 
combined station to one or more commands. See also 
command. 
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response header (RH). In SNA, a header, optionally 
followed by a response unit (RU), that indicates 
whether the response is positive or negative and that 
may contain a pacing response. See also negative 
response, pacing response, and positive response. 

response time. (1) The amount of time it takes after a 
user presses the enter key at the terminal until the 
reply appears at the terminal. (2) For response time 
monitoring, the time from the activation of a transaction 
until a response is received, according to the response 
time definition coded in the performance class. 

response time monitor (RTM). A feature available with 
certain hardware devices to allow measurement of 
response times, which may be collected and displayed 
by the NetView program. 

response unit (RU). In SNA, a message unit that 
acknowledges a request unit; it may contain prefix 
information received in a request unit. If positive, the 
response unit may contain additional information (such 
as session parameters in response to Bind Session), or 
if negative, contains sense data defining the exception 
condition. 

Restructured Extended Executor (REXX). An interpre- 
tive language used to write command lists. 

REXX. Restructured Extended Executor. 

RH. Request/response header. 

ring. A network configuration where a series of 
attaching devices are connected by unidirectional 
transmission links to form a closed path. 

route. See explicit route and virtual route. 

route extension (REX). In SNA, the path control 
network components, including a peripheral link, that 
make up the portion of a path between a subarea node 
and a network addressable unit (NAU) in an adjacent 
peripheral node. See also path, explicit route (ER) and 
virtual route (VR). 

routing. The assignment of the path by which a 
message will reach its destination. 

RPL exit routine. In VTAM, an application program exit 
routine whose address has been placed in the EXIT 
field of a request parameter list (RPL). VTAM invokes 
the routine to indicate that an asynchronous request 
has been completed. See EXLST exit routine. 

RTM. Response time monitor. 

RU. Request/response unit. 

SAW data. Synonym for session awareness (SAW) 
data. 



scope of commands. In the NetView program, the 
facility that provides the ability to assign different 
responsibilities to various operators. 

screen. An illuminated display surface; for example, 
the display surface of a CRT or plasma panel. Contrast 
with panel. 

scroll. To move all or part of the display image verti- 
cally to display data that cannot be observed within a 
single display image. See also page (2). 

SDLC. Synchronous Data Link Control. 

secondary half-session. In SNA, the half-session that 
receives the session-activation request. See also sec- 
ondary logical unit (SLU). Contrast with primary 
half-session. 

secondary logical unit (SLU). In SNA, the logical unit 
(LU) that contains the secondary half-session for a par- 
ticular LU-LU session. An LU may contain secondary 
and primary half-sessions for different active LU-LU 
sessions. Contrast with primary logical unit (PLU). 

secondary logical unit (SLU) key. A key-encrypting key 
used to protect a session cryptography key during its 
transmission to the secondary half-session. 

segment. (1) In the IBM Token-Ring Network, a 
section of cable between components or devices on the 
network. A segment may consist of a single patch 
cable, multiple patch cables connected together, or a 
combination of building cable and patch cables con- 
nected together. (2) See link connection segment. 

send pacing. In SNA, pacing of message units that a 
component is sending. See also receive pacing. 

sequence number. A number assigned to a particular 
frame or packet to control the transmission flow and 
receipt of data. 

Service Level Reporter (SLR). A licensed program that 
generates management reports from data sets such as 
System Management Facility (SMF) files. 

service point (SP). An entry point that supports appli- 
cations that provide network management for 
resources not under the direct control of itself as an 
entry point. Each resource is either under the direct 
control of another entry point or not under the direct 
control of any entry point. A service point accessing 
these resources is not required to use SNA sessions 
(unlike a focal point). A service "point is needed when 
entry point support is not yet available for some 
network management function. 

service reminder (SR). In the NetView/PC program, a 
notification set by the operator that is displayed on a 
panel and logs a specified message. 
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session. In SNA, a logical connection between two 
network addressable units (NAUs) that can be acti- 
vated, tailored to provide various protocols, and deacti- 
vated, as requested. Each session is uniquely 
identified in a transmission header (TH) by a pair of 
network addresses, identifying the origin and destina- 
tion NAUs of any transmissions exchanged during the 
session. See half-session, LU-LU session, SSCP-LU 
session, SSCP-PU session, and SSCP-SSCP session. 
See also LU-LU session type and PU-PU flow. 

session activation request. In SNA, a request that acti- 
vates a session between two network addressable units 
(NAUs) and specifies session parameters that control 
various protocols during session activity; for example, 
BIND and ACTPU. Contrast with session deactivation 
request. 

session awareness (SAW) data. Data collected by the 
NetView program about a session that includes the 
session type, the names of session partners, and infor- 
mation about the session activation status. It is col- 
lected for LU-LU, SSCP-LU, SSCP-PU, and SSCP-SSCP 
sessions and for non-SNA terminals not supported by 
NTO. It can be displayed in various forms, such as 
most recent sessions lists. 

session data. Data about a session, collected by the 
NetView program, that consists of session awareness 
data, session trace data, and session response time 
data. 

session deactivation request. In SNA, a request that 
deactivates a session between two network address- 
able units (NAUs); for example, UNBIND and DACTPU. 
Synonymous with generic unbind. Contrast with 
session activation request. 

session-initiation request. In SNA, an Initiate or logon 
request from a logical unit (LU) to a control point (CP) 
that an LU-LU session be activated. 

session-levei pacing. In SNA, a flow control technique 
that permits a receiver to control the data transfer rate 
(the rate at which it receives request units) on the 
normal flow. It is used to prevent overloading a 
receiver with unprocessed requests when the sender 
can generate requests faster than the receiver can 
process them. See also pacing and virtual route 
pacing. 

session monitor. The component of the NetView 
program that collects and correlates session-related 
data and provides online access to this information. 



session services. In SNA, one of the types of network 
services in the control point (CP) and in the logical unit 
(LU). These services provide facilities for an LU or a 
network operator to request that the SSCP initiate or 
terminate sessions between logical units. See config- 
uration services, maintenance services, and manage- 
ment services. 

session trace. In the NetView program, the function 
that collects session trace data for sessions involving 
specified resource types or involving a specific 
resource. 

session trace data. Data relating to sessions that is 
collected by the NetView program whenever a session 
trace is started and that consists of session activation 
parameters, VTAM path information unit (PIU) data, and 
NCP data. 

shared. Pertaining to the availability of a resource to 
more than one use at the same time. 

simulated logon. A session-initiation request gener- 
ated when a VTAM application program issues a 
SIMLOGON macroinstruction. The request specifies a 
logical unit (LU) with which the application program 
wants a session in which the requesting application 
program will act as the primary logical unit (PLU). 

single-domain network. In SNA, a network with one 
system services control point (SSCP). Contrast with 
multiple-domain network. 

SLR. Service Level Reporter. 

SLU. Secondary logical unit. 

SMF. System management facility. 

SNA. Systems Network Architecture. 

SNA network. The part of a user-application network 
that conforms to the formats and protocols of Systems 
Network Architecture. It enables reliable transfer of 
data among end users and provides protocols for con- 
trolling the resources of various network configura- 
tions. The SNA network consists of network 
addressable units (NAUs), boundary function compo- 
nents, and the path control network. 

SNA terminal. A terminal that supports Systems 
Network Architecture protocols. 

SNBU. Switched network backup. 



session parameters. 1n SNA, the parameters that 
specify or constrain the protocols (such as bracket pro- 
tocol and pacing) for a session between two network 
addressable units. See also logon mode. 

session partner. In SNA, one of the two network 
addressable units (NAUs) having an active session. 



solicited message. A response from VTAM to a 
command entered by a program operator. Contrast 
with unsolicited message. 

SP. Service point. 
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•pan. In the NetView program, a user-defined group of 
network resources within a single domain. Each major 
or minor node is defined as belonging to one or more 
spans. See also span of control. 

span of control. The total network resources over 
which a particular network operator has control. All 
the network resources listed in spans associated 
through profile definition with a particular network 
operator are within that operator's span of control. 

SR. Service reminder. 

SS. Start-stop. 



computers, terminals, or devices at a particular 
location. 

status monitor. A component of the NetView program 
that collects and summarizes information on the status 
of resources defined in a VTAM domain. 

subarea. A portion of the SNA network consisting of a 
subarea node, any attached peripheral nodes, and their 
associated resources. Within a subarea node, all 
network addressable units, links, and adjacent link 
stations (in attached peripheral or subarea nodes) that 
are addressable within the subarea share a common 
subarea address and have distinct element addresses. 



SSCP. System services control point. 

SSCP ID. In SNA, a number that uniquely identifies a 
system services control point (SSCP). The SSCP ID is 
used in session activation requests sent to physical 
units (PUs) and other SSCPs. 

SSCP-LU session. In SNA, a session between a 
system services control point (SSCP) and a logical unit 
(LU); the session enables the LU to request the SSCP to 
help initiate LU-LU sessions. 

SSCP-PU session. In SNA, a session between a 
system services control point (SSCP) and a physical 
unit (PU); SSCP-PU sessions allow SSCPs to send 
requests to and receive status information from indi- 
vidual nodes in order to control the network configura- 
tion. 

SSCP-SSCP session, in SNA, a session between the 
system services control point (SSCP) in one domain 
and the SSCP in another domain. An SSCP-SSCP 
session is used to initiate and terminate cross-domain 
LU-LU sessions. 

SSP. System Support Programs (IBM licensed 
program). Its full name is Advanced Communications 
Function for System Support Programs. Synonymous 
with ACF/SSP. 



subarea host node. A host node that provides both 
subarea function and an application program interface 
(API) for running application programs. It provides 
system services control point (SSCP) functions, 
subarea node services, and is aware of the network 
configuration. See boundary node, communication 
management configuration host node, data host node, 
host node, node, peripheral node, and subarea node. 
See also boundary function and node type. 

subarea link. In SNA, a link that connects two subarea 
nodes. See channel link and link. 

subarea node. In SNA, a node that uses network 
addresses for routing and whose routing tables are 
therefore affected by changes in the configuration of 
the network. Subarea nodes can provide gateway func- 
tion, and boundary function support for peripheral 
nodes. Type 4 and type 5 nodes are subarea nodes. 
See boundary node, host node, node, peripheral node, 
and subarea host node. See also boundary function 
and node type. 

subarea path control. The function in a subarea node 
that routes message units between network address- 
able units (NAUs) and provides the paths between 
them. See path control and peripheral path control. 
See also boundary function, peripheral node, and 
subarea node. 



ST. Session configuration screen abbreviation. 

•tart option. In VTAM, a user-specified or 
IBM-supplied option that determines certain conditions 
that are to exist during the time a VTAM system is 
operating. Start options can be predefined or specified 
when VTAM is started. 

statement. A language syntactic unit consisting of an 
operator, or other statement identifier, followed by one 
or more operands. See definition statement. 

station. (1) One of the input or output points of a 
network that uses communication facilities; for 
example, the telephone set in the telephone system or 
the point where the business machine interfaces with 
the channel on a leased private line. (2) One or more 



subarea PU. In SNA, a physical unit (PU) in a subarea 
node. 

subsystem. A secondary or subordinate system, 
usually capable of operating independent of, or asyn- 
chronously with, a controlling system. 

subvector. A subcomponent of the MAC major vector. 

supervisor. The part of a control program that coordi- 
nates the use of resources and maintains the flow of 
processing unit operations. 

supervisor call (SVC). A request that serves as the 
interface into operating system functions, such as allo- 
cating storage. The SVC protects the operating system 
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from inappropriate user entry. All operating system 
requests must be handled by SVCs. 

supervisor call (SVC) instruction. An instruction that 
interrupts the program being executed and passes 
control to the supervisor so that it can perform a spe- 
cific service indicated by the instruction. 

suppression character, in the NetView program, a 
user-defined character that is coded at the beginning of 
a command list statement or a command to prevent the 
statement or command from appearing on the opera- 
tor's terminal screen or in the network log. 

SVC. (1) Supervisor call. (2) Switched virtual circuit. 

switched connection. (1) (TC97) A mode of operating 
a data link in which a circuit or channel is established 
to switching facilities, for example, in a public switched 
network. (2) A connection that is established by 
dialing. (3) Contrast with nonswitched connection. 

switched major node. In VTAM, a major node whose 
minor nodes are physical units and logical units 
attached by switched SDLC links. 

switched network backup (SNBU). An optional facility 
that allows a user to specify, for certain types of PUs, a 
switched line to be used as an alternate path if the 
primary line becomes unavailable or unusable. 

switched virtual circuit (SVC). An X.25 circuit that is 
dynamically established when needed. The X.25 equiv- 
alent of a switched line. 



system services control point (SSCP) domain. The 

system services control point and the physical units 
(PUs), logical units (LUs), links, link stations and all the 
resources that the SSCP has the ability to control by 
means of activation requests and deactivation 
requests. 

Systems Network Architecture (SNA). The description 
of the logical structure, formats, protocols, and opera- 
tional sequences for transmitting information units 
through and controlling the configuration and operation 
of networks. 

System Support Programs (SSP). An IBM licensed 
program, made up of a collection of utilities and small 
programs, that supports the operation of the NCP. 

TAF. Terminal access facility. 

takeover. The process by which the failing active sub- 
system is released from its extended recovery facility 
(XRF) sessions with terminal users and replaced by an 
alternate subsystem. See resource takeover. 

task. A basic unit of work to be accomplished by a 
computer. The task is usually specified to a control 
program in a multiprogramming or multiprocessing 
environment. 

task panel. Online display from which you communi- 
cate with the program in order to accomplish the pro- 
gram's function, either by selecting an option provided 
on the panel or by entering an explicit command. See 
help panel. 



Synchronous Data Link Control (SDLC). A discipline 
for managing synchronous, code-transparent, 
serial-by-bit information transfer over a link con- 
nection. Transmission exchanges may be duplex or 
half-duplex over switched or nonswitched links. The 
configuration of the link connection may be 
point-to-point, multipoint, or loop. SDLC conforms to 
subsets of the Advanced Data Communication Control 
Procedures (ADCCP) of the American National Stand- 
ards Institute and High-Level Data Link Control (HDLC) 
of the International Standards Organization. 

system management facility (SMF). A standard feature 
of MVS that collects and records a variety of system 
and job-related information. 

system services control point (SSCP). In SNA, a 
central location point within an SNA network for man- 
aging the configuration, coordinating network operator 
and problem determination requests, and providing 
directory support and other session services for end 
users of the network. Multiple SSCPs, cooperating as 
peers, can divfde the network into domains of control, 
with each SSCP having a hierarchical control relation- 
ship to the physical units and logical units within its 
domain. 



TC. Transmission control. 

telecommunication line. Any physical medium such as 
a wire or microwave beam, that is used to transmit 
data. Synonymous with transmission line. 

terminal. A device that is capable of sending and 
receiving information over a link; it is usually equipped 
with a keyboard and some kind of display, such as a 
screen or a printer. 

terminal access facility (TAF). In the NetView 
program, a facility that allows a network operator to 
control a number of subsystems. In a full-screen or 
operator control session, operators can control any 
combination of such subsystems simultaneously. 

TERMINATE. In SNA, a request unit that is sent by a 
logical unit (LU) to its system services control point 
(SSCP) to cause the SSCP to start a procedure to end 
one or more designated LU-LU sessions. 

threshold. In the NetView program, refers to a per- 
centage value set for a resource and compared to a 
calculated error-to-traffic ratio. 
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time-out. (1) (ISO) An event that occurs at the end of 
a predetermined period of time that began at the occur- 
rence of another specified event. (2) A time interval 
allotted for certain operations to occur; for example, 
response to polling or addressing before system opera- 
tion is interrupted and must be restarted. 

time sharing option (TSO). An optional configuration of 
the operating system that provides conversational time 
sharing from remote stations. 

token. A sequence of bits passed from one device to 
another along the token ring. When the token has data 
appended to it, it becomes a frame. 

token ring. A network with a ring topology that passes 
tokens from one attaching device to another. For 
example, the IBM Token-Ring Network. 

transmission control (TC) layer. In SNA, the layer 
within a half-session that synchronizes and paces 
session-level data traffic, checks session sequence 
numbers of requests, and enciphers and deciphers 
end-user data. Transmission control has two compo- 
nents: the connection point manager and session 
control. See also half-session. 

transmission group (TG). In SNA, a group of links 
between adjacent subarea nodes, appearing as a 
single logical link for routing of messages. A trans- 
mission group may consist of one or more SDLC links 
(parallel links) or of a single System/370 channel. 

transmission header (TH). In SNA, control information, 
optionally followed by a basic information unit (BIU) or 
a BIU segment, that is created and used by path control 
to route message units and to control their flow within 
the network. See also path information unit. 



UNBIND. In SNA, a request to deactivate a session 
between two logical units (LUs). See also session 
deactivation request. Contrast with BIND. 

uninterpreted name. In SNA, a character string that a 
system services control point (SSCP) is able to convert 
into the network name of a logical unit (LU). Typically, 
an uninterpreted name is used in a logon or Initiate 
request from a secondary logical unit (SLU) to identify 
the primary logical unit (PLU) with which the session is 
requested. 

unsolicited message. A message, from VTAM to a 
program operator, that is unrelated to any command 
entered by the program operator. Contrast with so//c- 
ited message. 

upstream. In the direction of data flow from the end 
user to the host. Contrast with downstream. 

user. Anyone who requires the services of a com- 
puting system. 

user-application network. A configuration of data proc- 
essing products, such as processors, controllers, and 
terminals, established and operated by users for the 
purpose of data processing or information exchange, 
which may use services offered by communication 
common carriers or telecommunication Adminis- 
trations. Contrast with public network. 

user exit. A point in an IBM-supplied program at which 
a user routine may be given control. 

user exit routine. A user-written routine that receives 
control at predefined user exit points. User exit rou- 
tines can be written in assembler or a high-level lan- 
guage (HLL). 



transmission line. 

line. 



Synonym for telecommunication 



transmission priority. In SNA, a rank assigned to a 
path information unit (PIU) that determines its preced- 
ence for being selected by the transmission group 
control component of path control for forwarding to the 
next subarea node of the route used by the PIU. 

TSO. Time sharing option. 



using node. (1) In NCP, the NCP in the host's domain 
that reports a link error condition. (2) For the 
command facility of the NetView program and for 
NCCF, the ID parameter of certain network control com- 
mands. 

value. (1) (TC97) A specific occurrence of an attri- 
bute, for example, "blue" for the attribute "color." (2) A 
quantity assigned to a constant, a variable, a param- 
eter, or a symbol. 



type 2.1 node (T2.1 node). A node that can attach to an 
SNA network as a peripheral node using the same pro- 
tocols as type 2.0 nodes. Type 2.1 nodes can be 
directly attached to one another using peer-to-peer pro- 
tocols. See end node, node, and subarea node. See 
also node type. 

type 2.1 node (T2.1 node) control point domain. The 

CP, its logical units (LUs), links, link stations, and all 
resources that it activates and deactivates. 



variable, in the NetView program, a character string 
beginning with & that is coded in a command list and is 
assigned a value during execution of the command list. 

verb. (1) In SNA, the general name for a transaction 
program's request for communication services. (2) In 
VTAM, a programming language element in the logical 
unit (LU) 6.2 application program interface (API) that 
causes an LU 6.2 function to be performed. 
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viewing filter. In the NetView program, the function 
that allows a user to select the data to be displayed on 
a terminal. All other stored data is blocked. 

Virtual Machine (VM). A licensed program whose full 
name is the Virtual Machine/System Product (VM/SP). 
It is a software operating system that manages the 
resources of a real processor to provide virtual 
machines to end users. As a time-sharing system 
control program, it consists of the virtual machine 
control program (CP), the conversational monitor 
system (CMS), the group control system (GCS), and the 
interactive problem control system (IPCS). 

virtual route (VR). In SNA, a logical connection (1) 
between two subarea nodes that is physically realized 
as a particular explicit route, or (2) that is contained 
wholly within a subarea node for intranode sessions. A 
virtual route between distinct subarea nodes imposes a 
transmission priority on the underlying explicit route, 
provides flow control through virtual-route pacing, and 
provides data integrity through sequence numbering of 
path information units (PIUs). See also explicit route 
(ER), path, and route extension. 

virtual route (VR) pacing. In SNA, a flow control tech- 
nique used by the virtual route control component of 
path control at each end of a virtual route to control the 
rate at which path information units (PIUs) flow over the 
virtual route. VR pacing can be adjusted according to 
traffic congestion in any of the nodes along the route. 
See also pacing and session-level pacing. 

virtual route selection exit routine. In VTAM, an 
optional installation exit routine that modifies the list of 
virtual routes associated with a particular class of 
service before a route is selected for a requested 
LU-LU session. 

virtual storage. (ISO) The notion of storage space that 
may be regarded as addressable main storage by the 
user of a computer system in which virtual addresses 
are mapped into real addresses. The size of virtual 
storage is limited by the addressing scheme of the 
computer system and by the amount of auxiliary 
storage available, not by the actual number of main 
storage locations. 

Virtual Storage Access Method (VSAM). An access 
method for direct or sequential processing of fixed and 
variable-length records on direct access devices. The 
records in a VSAM data set or file can be organized in 
logical sequence by a key field (key sequence), in the 
physical sequence in which they are written on the data 
set or file (entry-sequence), or by relative-record 
number. 

Virtual Storage Extended (VSE). An IBM licensed 
program whose full name is the Virtual Storage 



Extended/ Advanced Function. It is a software oper- 
ating system controlling the execution of programs. 

Virtual Telecommunications Access Method (VTAM). 

An IBM licensed program that controls communication 
and the flow of data in an SNA network. It provides 
single-domain, multiple-domain, and interconnected 
network capability. 

vital product data. Product identification information 
such as machine type, model number, and serial 
number for hardware products. For software products, 
vital product data can be version and release level. 

VM. Virtual Machine operating system. Its full name is 
Virtual Machine/System Product. Synonymous with 
VM/SP. 

VM/SP. Virtual Machine/System Product operating 
system. Synonym for VM. 

VPD. vital product data 

VR. Virtual route. 

VSAM. Virtual Storage Access Method. 

VSE. Virtual Storage Extended operating system. Syn- 
onymous with VSE/AF. 

VSE/AF. Virtual Storage Extended/Advanced Function 
operating system. Synonym for VSE. 

VTAM. Virtual Telecommunications Access Method 
(IBM licensed program). Its full name is Advanced 
Communications Function for the Virtual Telecommuni- 
cations Access Method. Synonymous with ACF/VTAM. 

VTAM definition. The process of defining the user 
application network to VTAM and modifying 
IBM-defined characteristics to suit the needs of the 
user. 

VTAM operator command. A command used to 
monitor or control a VTAM domain. See also definition 
statement. 

wide area network. A network that provides data com- 
munication capability in geographic areas larger than 
those serviced by local area networks. Wide area net- 
works may extend across public rights-of-way. Con- 
trast with local area network. 

wrap. In general, to go from the maximum to the 
minimum in computer storage. For example, the con- 
tinuation of an operation from the maximum value in 
storage to the first minimal value. 

wrap count. In the NetView program, the number of 
events that can be retained on the data base for a spe- 
cific resource. 
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Learning About NetView: Operator Training 
(SK2T-0292) is an interactive PC-based operator 
training package that teaches SNA and basic network 
management concepts to new and inexperienced 
NetView operators. This training package uses 
graphics, animation and interactive NetView product 
simulations in a series of lessons to teach the basics of 
NetView operation. 

NetView Installation and Administration Guide 
(SC31-6018) helps system programmers install and 
prepare the NetView program for operation. It is 
arranged in a simplified, step-by-step style and is 
meant to be used in conjunction with the sample 
network documented in Network Program Products 
Samples. 

NetView Administration Reference (SC31-6014) is for 
system programmers and network operators who need 
a complete understanding of the NetView resource defi- 
nition statements. This book lists each statement in 
alphabetical order giving its purpose and location. 

NetView Tuning Guide (SC31-6079)i describes methods 
for controlling and improving the performance of the 
NetView Release 3 program. It is designed for system 
programmers who need to understand how NetView 
tuning values are determined and optimized. 

NetView Customization Guide (SC31-6016) is designed 
for system programmers and others who want to cus- 
tomize the NetView program to reflect their network's 
needs or operating procedures. This book focuses on 
the different application programming interfaces that 
can be customized and explains how to modify NetView 
help panels and problem determination displays. 

NetView Customization: Using PLII and C (SC31-6037) 
describes the ways system programmers can tailor the 
NetView program to satisfy unique requirements or 
operating procedures. It discusses the uses and 
advantages of user-written programs (exit routines, 
command processors, and subtasks). It also provides 
instructions in designing, writing, and installing user- 
written programs in PL/I and C. 

NetView Customization: Using Assembler (SC31-6078) 
describes the ways system programmers can tailor the 
NetView program to satisfy unique requirements or 
operating procedures. It discusses the uses and 



advantages of user-written programs (exit routines, 
command processors, and subtasks). It also provides 
instructions in designing, writing, and installing user- 
written programs in Assembler. 

NetView Customization: Writing Command Lists 
(SC31-6015) explains how to simplify network operator 
tasks by using command lists, it provides step-by-step 
instructions for writing simple and advanced command 
lists and for migrating from nccf message automation 
to NetView message automation. 

NetView Operation Primer (SC31-6020) provides a 
basic description of the network management task for 
new network operators. Topics include starting and 
stopping a network, controlling resources, monitoring a 
network, and gathering the necessary data to report a 
problem. 

NetView Operation (SC31-6019) provides system pro- 
grammers and experienced network operators a com- 
prehensive explanation of network management using 
the NetView program. Topics include detailed 
command explanation and panel flows, as well as infor- 
mation on how the various components interact with 
each other. 

NetView Command Summary (SX75-0026) is a refer- 
ence card that provides network operators with the 
format of all the commands and the commonly used 
NetView command lists. The commands are listed in 
alphabetical order by component. 

NetView Problem Determination and Diagnosis 
(LY43-0001) aids system programmers in identifying a 
NetView problem, classifying it, and describing it to an 
ibm Support Center. 

NetView Problem Determination Supplement for Man- 
agement Services Major Vectors 0001 and 0025 
(LD21-0023) describes major vectors 0001 and 0025 for 
system programmers and network operators involved 
in problem determination or diagnosis. The supple- 
ment may be used for the generic alert option and 
other problem determination tasks. 

NetView Resource Alerts Reference (SC31-6024) lists 
the messages sent by NetView-supported hardware 
and software resources. It helps system programmers 
analyze the messages into their component parts: 
action codes, event types, message text, and qualifiers. 
The book is a reference for those who need more infor- 
mation than online help provides. 
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NetView Storage Estimates (SK2T-1988) is an interac- 
tive PC-based tool that helps the user estimate storage 
requirements for NetView, This tool can be used for 
planning, installation, and tuning purposes. It is 
intended for network planners, system programmers, 
and IBM service personnel. 

Console Automation Using NetView: Planning 
(SC31-6058) describes an approach to automate the 
way a system handles messages and responses to 
alerts. It includes information you should know before 
beginning such automation, as well as sample plans 
and proposals you might find useful in promoting your 
automation concept. This book includes planning infor- 
mation for MVS, VM, and VSE users of the NetView 
program. 

NetView/PC Publications 

NetView/PC Planning, Installation, and Customization 
(SC31-6002) provides planning, installation, and 
customization information on NetView/PC and explains 
the communication requirements upstream to the host 
and downstream to supported devices. Information 
relating to the required pc environment and host pro- 
ducts that support NetView/PC is also provided. It also 
discusses topics that are of general interest when you 
are ordering your equipment. 

NetView/PC Application Program 
Interface/Communications Services Reference 
(SC31-6004) is a reference for os/2 programmers who 
use the api/cs and for system programmers who write 
command processors to run under NetView. The api/cs 
provides a means for vendor and other external appli- 
cations to use the communication services of 
NetView/PC. 

NetView/PC Operation (SC31-6003) describes how to 
operate the program and diagnose problems in 
NetView/PC. 

NetView/PC Quick Reference (SX75-0016) describes all 
of the functions of the F-keys throughout the 
NetView/PC program. 



Other Network Program 
Products Publications 

For more information about the books listed in this 
section, see Bibliography and Master Index for 
NetView, NCP, and VTAM. 



Network Program Products General Information 
(GC30-3350) 

Network Program Products Planning (SC30-3351) 

Network Program Products Samples (SC30-3352) 

Bibliography and Master Index for NetView, NCP, and 
VTAM (GC31-6081)2 

VTAM Publications 

The following list shows the books for vtam V3R2. For 
information about the books for vtam V3R1, V3R1.1, or 
V3R1.2, see any vtam V3R2 book or the Network Program 
Products Bibliography and Master Index. 

VTAM Installation and Resource Definition (SC23-0111) 

VTAM Customization (LY30-5614) 

VTAM Directory of Programming Interfaces for Cus- 
tomers (GC31-6403) 

VTAM Operation (SC23-0113) 

VTAM Messages and Codes (SC23-0114) 

VTAM Programming (SC23-0115) 

VTAM Programming for LU 6.2 (SC30-3400) 

VTAM Diagnosis Guide (LY30-5601) 

VTAM Data Areas for MVS (LY30-5592) 

VTAM Data Areas for VM (LY30-5593) 

VTAM Data Areas for VSE (LY30-5594) 

VTAM Reference Summary (LY30-5600) 

NCP, SSP, and EP Publications 

The following list shows the related books for ncp V4 
and ncp vs. 

NCP, SSP, and EP Generation and Loading Guide 
(SC30-3348) 

NCP, SSP, and Related Products Directory of Program- 
ming Interfaces for Customers (GC31-6202) 

NCP Migration Guide (SC30-3252 for NCP V4 and 
SC30-3440 for NCP V5) 
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NCP, SSP, and EP Resource Definition Guide 
(SC30-3349 for NCP V4 and SC30-3447 for NCP V5) 

NCP, SSP, and EP Resource Definition Reference 
(SC30-3254 for NCP V4 and SC30-3448 for NCP V5) 

NCP and EP Reference Summary and Data Areas 
(LY30-5570 for NCP V4 and LY30-5603 for NCP V5) 

NCP Customization Guide (LY30-5571 for NCP V4 
LY30-5606 for NCP V5) 



NCP Customization Reference (LY30-5612 for NCP V4 
and LY30-5607 for NCP V5) 

SSP Customization (LY43-0021) 

NCP, SSP, and EP Messages and Cades (SC30-3169) 

NCP, SSP, and EP Diagnosis Guide (LY30-5591) 

NCP and EP Reference (LY30-5569 for NCP V4 and 
LY30-5605 for NCP V5) 
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A (Alert) Statement- 5 




AAUCNMTD member, DSTINIT statement 


AAUICPEX, INITMOD operand 47 


AAUINLDM, INITMOD operand 


AUTHORIZ operand 


48 


BUFNUM operand 


48 


BUFSIZE operand 


48 


BUFTYPE operand 


48 


KEEPDISC operand 


50 


KEEPMEM operand 


51 


KEEPPIU operand 


50 


KEEPRTM operand 


50 


LOG operand 49 




LUCOUNT operand 


51 


MAXEND operand 


48 


NETID operand 50 




PERFMEM operand 


50 


RTM operand 49 




RTMDISP operand 


49 


SAW operand 48 




SESSTATS operand 


49 


TRACELU operand 


49 


TRACESC operand 


49 


AAUPRMLP member 




DSTINIT statement 


24 


INITMOD statement 


47 



24 



abnormal end value 60 
ACB 

primary data set 25 

secondary data set 25 
ACBNAME, VPDINIT operand 95 
access method services 26 
action-name operands, IF-THEN statement 

BEEP 44 

DISPLAY 44 

HCYLOG 45 

HOLD 45 

NETLOG 45 

SYSLOG 46 
actions, IF-THEN statement 

execute-actions 42 

yes-or-no-actions 44 
administration, system 3 
AFTER command 14 
alert 

focal point 22 

user 21 
alias name translation 7 
ALIASMEM statement 7 
allocating storage 90 
ALL, IF-THEN operand 43 



AL, W (Wrap) operand 98 
AMS 

See access method services 
application name 

CNM data transfer task 19 

NetView 12, 67 
APPLS, T (Timer) operand 91 
ASSIGN command 9, 45 
AT command 14 
AUTH statement 8 
AUTHDOM, AAUICPEX operand 47 
authorized receiver, message 8 
AUTHORIZ, AAUINLDM operand 48 
AUTOFLIP, LOGINIT operand 56 
automation 

message 34 

task, reinstating 60 
AUTOMSG command 34 
AUTOTASK command 70 

B 

BACKUP, DEFFOCPT operand 22 
BEEP, IF-THEN operand 44 
BINDFAIL, KCLASS operand 54 
bitstring-function comparison-expression, IF-THEN 

operand 40 
bitstring-names, IF-THEN statement 

DESC 41 

ROUTCDE 41 

BNJAPAMA member 

BNJMBDST member 

CTL statement 21 

DSTINIT statement 

R (Ratio) statement 

RATE statement 82 

REPORTS statement 83 

W (WRAP) statement 97 
BNJ36DST member, DSTINIT statement 24 
BOUNDS, PCLASS operand 74 
buffers, VSAM 96 
BUFNUM, AAUINLDM operand 48 
BUFSIZE, AAUINLDM operand 48 
BUFTYPE, AAUINLDM operand 48 



C (Command List) statement 10 
CDMNSESS statement 11 
CDRMDEF statement 12 
CDRSC, VTAM definition statement 
character translation sets 93 
class 

keep 53, 58 



21 



24 
81 



57 
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class (continued) 
performance 58 
scope 13 
service 20 
CLOSE command 27 
CMDCLASS statement 13 
CMDMDL statement 14 
CMDSYN statement 17 
CMD, IF-THEN operand 42 
CNM data transfer 18, 19 
CNMAUTH statement 18 
CNMFANGC module 30 
CNMTARG statement 19 
coding conventions viii 
command 
defining 14 
echoing to screen 15 
module, loading at initialization 15 
operands, defining synonyms 73 
restricting usage of 13 
run automatically at initialization 66 
scope checking 13 
keywords 55 
values 94 
synonyms, defining 17 
type 14 
command list 
defining 14 
definition of viii 
displaying 10 
restricting usage of 13 
run automatically at initialization 66 
scope checking 13 
synonyms, creating 17 
comments 4 

compare-items, IF-THEN statement 
literals 37 
place-holders 39 
variable-names 38 
comparison-expressions, IF-THEN statement 
bitstring-function 40 
parse-function 36 
token-function 40 
COS statement 20 
cross-domain 

authorization 23, 47 
sessions 

data retrieval 12 
global 84 

maximum number of 11 
CTL 

AUTH operand 8 
CMDMDL operand 15 
CNMAUTH operand 18 
statement 21 



DASD, KCLASS operand 54 
data services command processor 25 
data services request blocks 25 
DATA, KCLASS operand 54 
DEFAULTS command 46 
DEFFOCPT statement 22 
DESC, IF-THEN operand 41 
DISPLAY, IF-THEN operand 44 
DMNPSW, NCCFID operand 67 
DOMAINID 

IF-THEN operand 36 
NCCFID operand 67 
DOMAINS statement 23 
domain, cross 

See cross-domain 
DROP, NCCFID operand 67 
DSCP 

See data services command processor 
DSIALATD member 

ALIASMEM statement 7, 8 
DSTINIT statement 24 
DSIALTAB member 
COS statement 20 
LU statement 57 
MODE statement 64 
ORIGNET statement 72 
DSIAMLTD member 

CDRMDEF statement 12 
DSTINIT statement 24 
DSICMD member 

CMDCLASS statement 13 
CMDMDL statement 14 
CMDSYN statement 17 
KEYCLASS statement 55 
PARMSYN statement 73 
VALCLASS statement 94 
DSICNM member 

A (Alert) statement 5 
C (Command List) statement 10 
F (Filter) statement 29 
O MONIT statement 68 
T (Timer) statement 91 
DSICPINT member, DSTINIT statement 24 
DSICRTR, CNM router subtask 25 
DSICRTTD member 

DEFFOCPT statement 22 
DSTINIT statement 24 
DSICTMOD data set 27 
DSIDMN member 

CDMNSESS statement 11 
HARDCOPY statement 32 
MAXABEND statement 60 
MAXLOGON statement 61 
MAXSPAN statement 62 
NCCFIC statement 66 
NCCFID statement 67 
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DSIDMN member (continued) 
OPTIONS statement 71 
POS statement 77 
POSPOOL statement 78 
RRD statement 84 
STORPOOL statement 90 
TASK statement • 92 
TRANSTBL statement 93 
VSAMLSR statement 96 
DSIELMEM member, DSTINIT statement 24 
DSIHMF member, HOLDMSG statement 33 
DSILOGBK member 
DSTINIT statement 24 
LOGINIT statement 56 
DSILUCTD member 

CNMAUTH statement 18 
CNMTARG statement 19 
DSTINIT statement 24 
DSIOPF member 

OPERATOR statement 70 
PROFILEN statement 80 
DSIPARM data set 

AAUCNMTD member, DSTINIT statement 24 
AAUPRMLP member 

DSTINIT statement 24 

INITMOD statement 47 
BNJMBDST member 

CTL statement 21 

DSTINIT statement 24 

R (Ratio) statement 81 

RATE statement 82 

REPORTS statement 83 

W (Wrap) statement 97 
BNJ36DST member, DSTINIT statement 24 
DSIALATD member 

ALIASMEM statement 7 

DSTINIT statement 24 
DSIALTAB member 

COS statement 20 

LU statement 57 

MODE statement 64 

ORIGNET statement 72 
DSIAMLTD member 

CDRMDEF statement 12 

DSTINIT statement 24 
DSICMD member 

CM DCLASS statement 13 

CMDMDL statement 14 

CMDSYN statement 17 

KEYCLASS statement 55 

PARMSYN statement 73 

VALCLASS statement 94 
DSICNM member 

A (Alert) statement 5 

C (Command List) statement 10 

F (Filter) statement 29 

O MONIT statement 68 

T (Timer) statement 91 



DSIPARM data set (continued) 

DSICPINT member, DSTINIT statement 24 
DSICRRTD member 

DEFFOCPT statement 22 - 

DSTINIT statement 24 
DSIDMN member 

CDMNSESS statement 11 

HARDCOPY statement 32 

MAXABEND statement 60 

MAXLOGON statement 61 

MAXSPAN statement 62 

NCCFIC statement 66 

NCCFID statement 67 

OPTIONS statement 71 

POS statement 77 

POSPOOL statement 78 

RRD statement 84 

STORPOOL statement 90 

TASK statement 92 

TRANSTBL statement 93 

VSAMLSR statement 96 
DSIELMEM member, DSTINIT statement 24 
DSIHMF member, HOLDMSG statement 33 
DSILOGBK member 

DSTINIT statement 24 

LOGINIT statement 56 
DSILUCTD member 

CNMAUTH statement 18 

CNMTARG statement 19 

DSTINIT statement 24 
DSIOPF member 

OPERATOR statement 70 

PROFILEN statement 80 
DSISPN member, SPANLIST statement 86 
DSITRCBK member 

DSTINIT statement 24 

LOGINIT statement 56 
DSIVPARM member, VPDINIT statement 95 
IF-THEN automation statement 34 
KEEPMEM member 

KCLASS statement 53 

MAPSESS statement 58 
PERFMEM member 

MAPSESS statement 58 

PCLASS statement 74 
USRSQMEM member, DSTINIT statement 24 
VSAM members 

AAUCNMTD 24 

AAUPRMLP 24 

BNJMBDST 24 

BNJ36DST 24 

DSIALATD 24 

DSIAMLTD 24 

DSICPINT 24 

DSICRRTD 24 

DSIELMEM 24 

DSILOGBK 24 

DSILUCTD 24 

DSITRCBK 24 
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DSIPARM data set (continued) 
VSAM members (continued) 
USRSQMEM 24 
DSIPRF data set 
DSIPROFA member 
AUTH statement 8 
DOMAINS statement 23 
ISPAN statement 52 
PROFILE statement 79 
SPAN statement 85 
DSIPROFB member 

OPCLASS statement 69 
PROFILE statement 79 
DSIPROFA member 
AUTH statement 8 
DOMAINS statement 23 
ISPAN statement 52 
PROFILE statement 79 
SPAN statement 85 
DSIPROFB member 

OPCLASS statement 69 
PROFILE statement 79 
DSISPN member, SPANLIST statement 
DSITRCBK member 

DSTINIT statement 24 
LOGINIT statement 56 
DSIVPARM member, VPDINIT statement 
DSIVTAM data set 

minor node definition statements 63 
STATOPT statement 87 
DSIWLS macro 26 
DSPLYLOC, PCLASS operand 74 
DSRB 

See data services request blocks 
DSRBO, DSTINIT operand 25 
DSRBU, DSTINIT operand 
DST initialization 
exit routine 12 

AAUINIT, defined as 
DSIAINIT, defined as 
DSILINIT, defined as 
parameters 24 
DSTINIT statement 24 



86 



95 



25 



47 
7 
12,18,19 



EBCDIC character set 93 
ECHO, DSTINIT operand 15 
END statement 4 
error-to-traffic ratio value 81 
ER, MAPSESS operand 59 
event logging 82 
EVERY command 14 
EV, W (Wrap) operand 97 
execute-actions 42" 
EXEC, IF-THEN operand 42 
exit routine . 12, 47 



external log record formats 
hardware monitor 101 
session monitor 108 

accounting and availability data collection 
record 109 

bind failure record 109 

combined session start-end record 109 

init failure record 110 

RTM collection record 108 

session end record 108 

session start record 109 

storage and event counter record 110 

subvector formats 1 1 1 



F (Filter) statement 29 
FAILURES, KCLASS operand 54 
focal point nodes, defining 22 
FORCE command 54 
FUNCT, DSTINIT operand 24 

H 

hard-copy printers, defining 32 
HARDCOPY statement 32 
hardware monitor 
data base 

event logging 82 
external log formats 101 
E/T ratios, specifying 97 
wrap counts, specifying 97 
focal point nodes 22 
report record logging 83 
HCL, PROFILE operand 79 
HCYLOG, IF-THEN operand 45 
HDRMTYPE, IF-THEN operand 36 
help panels 17 
HOLDMSG statement 33 
HOLD, IF-THEN operand 45 

I 

IC 

NCCFIC operand 66 
PROFILE operand 79 
IF-THEN automation statement 34 
INITFAIL, KCLASS operand 54 
initialization 

command list, running automatically at 66 
command module, loading at 15 
command, running automatically at 66 
parameters 
DST 24 

Netview sequential log 56 
network log 56 
trace log 56 
VPDTASK 95 
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initialization (continued) 
record logging at 83 
INITMOD statement 47 
INIT, TASK operand 92 
installation parameters 
interconnected network 
ISPAN statement 52 



47 
20,57 



Japanese, character translation 93 
JOBNAME, IF-THEN operand 36 

K 

Kanji, character set 93 
Katakana, character set 93 
KCLASS 

MAPSESS operand 58 

statement 53 
keep class 

defining 53 

mapping sessions into 58 
KEEP PIUS command 50 
KEEPDISC, AAUINLDM operand 50 
KEEPMEM member 51 

KCLASS statement 53 

MAPSESS statement 58 
KEEPPIU 

AAUINLDM operand 50 

KCLASS operand 54 
KEEPRTM, AAUINLDM operand 50 
KEYCLASS statement 55 

L 

labels 4 

LBUILD macro 87 

literal compare-item, IF-THEN statement 37 

local shared resources 27 

logical unit (LU) name 

SeeLU 
LOGINIT statement 56 
logon 

attempts, specifying maximum 61 

mode names 64 

security 71 
LOG, AAUINLDM operand 49 
LU 

CNMTARG operand 19 

names 

defining 19 
translating 57 

number in network 51 

session authorization 18, 19 

statement 57 
LUCOUNT, AAUINLDM operand 51 



M 

MACRF, DSTINIT operand 27 
MAPSESS statement 58 
MAXABEND statement 60 
MAXEND, AAUINLDM operand 48 
MAXLOGON statement 61 
MAXSESS, CNMAUTH operand 18 
MAXSPAN statement 62 
member, definition of viii 
MEM, TASK operand 92 
message 

authorized receiver 8 

automation 34 

buffer, parsing 16 

holding on operator screen 33 

indicator classes 5, 29 
defining alarm attribute 5 
defining color attribute 5 
defining highlighting attribute 5 

unsolicited 8 
MOD 

CMDMDL operand 14 

TASK operand 92 

TRANSTBL operand 93 
mode names, logon 64 
MODE statement 64 
modem configuration change form 137 
monitor 

hardware 

See hardware monitor 

session 

See session, monitor . 

status 

See status monitor 
MOVE command 60 
MSGCMD statement 65 
MSGID, IF-THEN operand 37 
MSGRECVR, AUTH operand 8 
MSGROUTE command 42 
MVS, definition of viii 

N 

NCCFIC statement 66 
NCCFID statement 67 
NETID, AAUINLDM operand 50 
NETLOG, IF-THEN operand 45 
NetView 

application name 12, 67 

sequential log 56 
network 

interconnected 20 

log 5 

initial parameters 56 
placing messages in 45 

name, defining 72 
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network asset management 

sample command list record formats 

DCE hardware subrecords 135 

end subrecords 133 

error subrecords 136 

PU hardware srjbrecords 134 

PU software subrecords 134 

start subrecords 132 

subrecord prefix 132 

timeout subrecords 136 
vital product data descriptions 

answering node configuration data 123 

attached device configuration data 130 

DCE data for DSUs/CSUs 1 27 

DCE data for modems 126 

link configuration data 128 

LPDA2 sense data 129 

product data 124 
node 

focal point 22 
major, defining 89 
minor, defining 63 
reactivation 68 
VTAM 86, 87 



O MONIT statement 68 
OBJPCT, PCLASS operand 76 
OBJTIME, PCLASS operand 74 
OFF, REPORTS operand 83 
ONE, IF-THEN operand 43 
ON, REPORTS operand 83 
OPCLASS statement 69 
operands 

AAUICPEX, INITMOD statement 47 
AAUINLDM, INITMOD statement 

AUTHORIZ 48 

BUFNUM 48 

BUFSIZE 48 

BUFTYPE 48 

KEEPDISC 50 

KEEPMEM 51 

KEEPPIU 50 

KEEPRTM 50 

LOG 49 

LUCOUNT 51 

MAXEND 48 

NETID 50 

PERFMEM 50 

RTM 49 

RTMDISP 49 

SAW 48 

SESSTATS 49 

TRACELU 49 

TRACESC 49 
ACBNAME, VPDINIT statement 95 
ALL, IF-THEN statement 43 



operands (continued) 

AL, W (Wrap) statement 98 
APPLS, T (Timer) Statement 91 
AUTHDOM, INITMOD statement 47 
AUTOFLIP, LOGINIT statement 56 
BACKUP, DEFFOCPT statement 22 
BEEP, If-THEN statement 44 
BINDFAIL, KCLASS statement 54 
BOUNDS, PCLASS statement 75 
CMD, IF-THEN statement 42 
CTL 

AUTH statement 8 

CMDMDL statement 15 

CNM AUTH statement 18 
DASD, KCLASS statement 54 
DATA, KCLASS statement 54 
defining synonyms for 73 
DESC, IF-THEN statement 41 
DISPLAY, IF-THEN statement 44 
DMNPSW, NCCFID statement 67 
DOMAINID 

IF-THEN statement 36 

NCCFID statement 67 
DROP, NCCFID statement 67 
DSPLYLOC, PCLASS statement 75 
DSRBO, DSTINIT statement 25 
DSRBU, DSTINIT statement 25 
ECHO, CMDMDL statement 15 
ER, MAPSESS statement 59 
EV, W (Wrap) statement 97 
EXEC, IF-THEN statement 42 
FAILURES, KCLASS statement 54 
FUNCT, DSTINIT statement 24 
HCL, PROFILE statement 79 
HCYLOG, IF-THEN statement 45 
HDRMTYPE, IF-THEN statement 36 
HOLD, IF-THEN statement 45 
IC 

NCCFIC statement 66 

PROFILE statement 79 
INITFAIL, KCLASS statement 54 
INIT, TASK statement 92 
JOBNAME, IF-THEN statement 36 
KCLASS, KCLASS statement 58 
KEEPPIU, KCLASS statement 54 
LU, CNMTARG statement 19 
MACREF, DSTINIT statement 27 
MAXSESS, CNM AUTH statement 18 
MEM, TASK statement 92 
MOD 

CMDMDL statement 14 

TASK statement 92 

TRANSTBL statement 93 
MSGID, IF-THEN statement 37 
MSGRECVR, AUTH statement 8 
NETLOG, IF-THEN statement 45 
OBJPCT, PCLASS statement 76 
OBJTIME, PCLASS statement 75 
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operands (continued) 

OFF, REPORTS statement 83 
ONE, IF-THEN statement 43 
ON, REPORTS statement 83 
OTHER 

KEYCLASS statement 55 

VALCLASS statement 94 
PARSE, CMDMDL statement 16 
PASSWORD 

OPERATOR statement 70 

VPDINIT statement 95 
PBSDN, DSTINIT statement 24 
PCLASS, MAPSESS statement 58 
PDDNM, DSTINIT statement 25 
PENDING, T (Timer) Statement 91 
PERSIST 

CNMTARG statement 19 

DSTINIT statement 27 
PPASS, DSTINIT statement 25 
PPT, IF-THEN statement 43 
PRI 

MAPSESS statement 58 

TASK statement 92 
PRIMARY, DEFFOCPT statement 22 
RESUME, LOGINIT statement 56 
RES, CMDMDL statement 15 
RETRY 

CDRMDEF statement 12 

DSTINIT statement 27 
ROUTCDE, IF-THEN statement 41 
ROUTE, IF-THEN statement 42 
RTDEF, PCLASS statement 75 
RTMDATA, KCLASS statement 54 
SAW, KCLASS statement 53 
SBSDN, DSTINIT statement 25 
SDDNM, DSTINIT statement 25 
SEC, MAPSESS statement 59 
SESSFAIL, KCLASS statement 54 
SESSID, IF-THEN statement 37 
SESSNORM, KCLASS statement 54 
SIZE, STORPOOL statement 90 
SNAPRQ, VPDINIT statement 95 
SPAN, minor node definitions 63 
SPASS, DSTINIT statement 25 
ST, W (Wrap) statement 97 
SUPPCHAR, NCCFID statement 67 
SYSID, IF-THEN statement 37 
SYSLOG, IF-THEN statement 46 
TEXT, IF-THEN statement 37 
TOKEN, IF-THEN statement 40 
TP, MAPSESS statement 59 
TRACDATA, KCLASS statement 54 
TSKID, TASK statement 92 
TYPE, CDRMDEF statement 14 
UNSOL, DSTINIT statement 25 
VERIFY, OPTIONS statement 71 
VPDREQ, VPDINIT statement 95 
VPDSTOR, VPDINIT statement 95 



operands (continued) 

VPDWAIT, VPDINIT statement 95 
VR, MAPSESS statement 59 
XITBN, DSTINIT statement 26 
XITBO, DSTINIT statement 26 " 
XITCI, DSTINIT statement 26 
XITCO, DSTINIT statement 26 
XITDI, DSTINIT statement 26 
XITVI, DSTINIT statement 26 
XITVN, DSTINIT statement 26 
XITVO, DSTINIT statement 26 
XITXL, DSTINIT statement 26 

OPERATOR 

authority, defining 8 
autotask 9 

cross-domain sessions 23, 84 
logon 70 

attempts, specifying maximum 61 
security 71 
profile 23, 79, 80 
routing messages to 8 
scope of commands 69 
span of control 
NetView 8 
VTAM 85 
statement 70 

OPTIONS statement 71 

ORIGNET statement 72 

OTHER 

KEYCLASS operand 55 
VALCLASS operand 94 

OVERRIDE command 46 



PARMSYN statement 73 

parse-function comparison-expressions 36 

parse-names 

DOMAINID 36 

HDRMTYPE 36 

JOBNAME 36 

MSGID 37 

SESSID 37 

SYSID 37 

TEXT 37 
PARSE, CMDMDL operand 16 
PASSWORD 

OPERATOR operand 70 

VPDINIT operand 95 
PBSDN, DSTINIT operand 24 
PCCU macro 87 
PCLASS 

MAPSESS operand 58 

statement 74 
PDDNM, DSTINIT operand 25 
PENDING, T (Timer) operand 91 
PERFMEM 

AAUINLDM operand 50 
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PERFMEM (continued) 

MAPSESS statement 58 

PCLASS statement 74 
performance class, mapping sessions into 58 
PERSIST 

CNMTARG operand 19 

DSTINIT operand 27 
persistent sessions 19, 27 
place-holder compare-item 39 
POS statement 77 
POSPOOL statement 78 
PPASS, DSTINIT operand 25 
PPT 

IF-THEN operand 43 

routing messages to 43 
PRI 

MAPSESS operand 58 

TASK operand 92 
PRIMARY, DEFFOCPT operand 22 
PROFILE 

defining 79 

operator 80 

statement 79 
PROFILEN statement 80 



R (Ratio) statement 81 
RATE statement 82 
ratio, error-to-traffic (E/T) 81 
report record logging 83 
REPORTS statement 83 
RESET IMMED command 60 
response time monitor 49, 74 
RESUME, LOGINIT operand 56 
RES, CMDMDL operand 15 
RETRY 

CDRMDEF operand 12 

DSTINIT operand 27 
REXX, definition of viii 
ROUTCDE, IF-THEN operand 41 
ROUTE, IF-THEN operand 42 
RRD statement 84 
RTDEF, PCLASS operand 74 
RTMDATA, KCLASS operand 54 
RTMDISP, AAUINLDM operand 49 
RTM, AAUINLDM operand 49 



sample command list record formats, network asset 
management 

See network asset management 
SAW 

AAUINLDM operand 48 

KCLASS operand 53 
SBSDN, DSTINIT operand 25 



scope checking 

command lists 13, 14 

commands 13, 14, 69 
keywords 55, 139 
values 94, 139 
SDDNM, DSTINIT operand 25 
security, operator 71 
SEC, MAPSESS operand 59 
service, class of 20 
SESSFAIL, KCLASS operand 54 
SESSID, IF-THEN operand 37 
session 

awareness 48 

CNM data transfer 18 

cross-domain 11, 12 

ending 67 

LU, authorization 18, 19 

monitor 12 

conversations 12, 27 
external log record formats 108 
installation parameters 47 
session data retrieval 12 

operator, reinstating 60 

parallel 18 

persistent 19 

TAF 29 

terminal, reinstating 60 
SESSNORM, KCLASS operand 54 
SESSTATS, AAUINLDM operand 49 
SIZE, STORPOOL operand 90 
SNAPRQ, VPDINIT operand 95 
SPAN 

minor node definition operand 63 

names, number allowed 62 

statement 85 

VTAM 85, 86 
SPANLIST statement 86 
SPASS, DSTINIT operand 25 
SSCP 12 

See also system services control point (SSCP) 
SSI 37 

See also subsystem interface 
START command 60 
STATOPT statement 87 
status monitor 

displaying commands or command lists 10 

functions 87 

important message indicator 45 

reactivating nodes 68 
STOP command 52, 60 
storage allocation 90 
STORPOOL statement 90 
ST, W (Wrap) operand 97 
subsystem interface 37 
SUPPCHAR, NCCFID operand 67 
suppressing output 67 
synonyms, defining 

command lists 17 
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synonyms, defining (continued) 

commands 17 

operands 73 
syntax conventions 4 
SYSID, IF-THEN operand 37 
SYSLOG, IF-THEN operand 46 
system services control point (SSCP) 

cross-domain, name 12 

information, tracing 49 

LUs owned by 51 

session awareness data for 53 



T (Timer) statement 91 

TAF sessions 29 

TASK statement 92 

tasks, defining 92 

terminals, defining 77, 78 

TEXT, IF-THEN operand 37 

timers, controlling VTAM commands with 91 

token-function comparison-expressions 40 

TOKEN, IF-THEN operand 40 

TP, MAPSESS operand 59 

TRACDATA, KCLASS operand 

trace 

data 48, 50 

log 56 
TRACELU, AAUINLDM operand 
TRACESC, AAUINLDM operand 
translation 

alias name 7 

character 93 
TRANSTBL statement 93 
TSKID, TASK operand 92 
TYPE, CMDMDL statement 14 



54 



49 
49 



u 



unsolicited messages, routing to an operator 

UNSOL, DSTINIT operand 25 

USRSQMEM member, DSTINIT statement 24 



VALCLASS statement 94 
variable-name compare-item 38 
VBUILD macro 87 
VERIFY, OPTIONS operand 71 
vital product data descriptions, network asset manage- 
ment 
See network asset management 
VM, definition of viii 
VPDINIT statement 95 
VPDREQ, VPDINIT operand 95 
VPDSTOR, VPDINIT operand 95 
VPDTASK NetView subtask 95 



VPDWAIT, VPDINIT operand 95 
VR, MAPSESS operand 59 
VSAM 

buffers 96 

file, mapping sessions to 54 - 

members 

AAUCNMTD member 24 

AAUPRMLP member 24 

BNJMBDST member 24 

BNJ36DST member 24 

DSIALATD member 24 

DSICPINT member 24 

DSIELMEM member 24 

DSILOGBK member 24 

DSILUCTD member 24 

DSITRCBK member 24 

USRSQMEM member 24 
services 25 
VSAMLSR statement 96 
VTAM 

CDRCS definition statement 57 
commands, controlling with timers 91 
definition of viii 
SPAN operand 63 
spans 85, 86 

W 

W (Wrap) statement 97 
wrap count 

initial 21,97 

statements 21 



XITBN, DSTINIT operand 26 

XITBO, DSTINIT operand 26 

XITCI, DSTINIT operand 26 

XITCO, DSTINIT operand 26 

XITDI, DSTINIT operand 26 

XITVI, DSTINIT operand 26 

XITVN, DSTINIT operand 26 

XITVO, DSTINIT operand 26 

XITXL, DSTINIT operand 26 



yes-or-no-actions 44 
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